home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / tagd26d.zip / MENU26D.DOC < prev    next >
Text File  |  1993-01-24  |  155KB  |  3,712 lines
  1.                        /======================================\
  2.                       < T.A.G. Version 2.6d Menu Documentation >
  3.                        \======================================/
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.       
  18.  
  19.                                            
  20.    /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  21.   /\/\/\/                     [>> Welcome to <<]                       \/\/\/\
  22.  |   /\/      ______________        ______          ___________         \/\   |
  23.  |  / /      /             /|      /     /|        /          /\         \ \  |
  24.  | / /       TTTTTTTTTTTTTT/       AAAAAA /|       GGGGGGGGGGG\/|         \ \ |
  25.  |/\/ /\           TT |           AA|___AA /|      GG |      GG/        /\ \/\|
  26.  |-< <  >          TT |          AA/     AA /|     GG |   _____        <  > >-|
  27.  |\/\ \/           TT |         AAAAAAAAAAAA |     GG |  /     /|       \/ /\/|
  28.  | \ \             TT |         AA |      AA |     GG |__GGGGGG |         / / |
  29.  |  \ \            TT |         AA |      AA |     GG/       GG |        / /  |
  30.  |   \/\           TT/   <>     AA/       AA/  <>   GGGGGGGGGGG/  <>    /\/   |
  31.   \/\/\/\                                                              /\/\/\/
  32.    \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                             /============================\
  59.                            / T.A.G. Bulletin Board System \
  60.                           <    Copyright (C) 1986-1993     >
  61.                            \        The T.A.G. Team       /
  62.                             \============================/
  63.  
  64.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  65.      ===========================================================================
  66.  
  67.                               >>> Table of Contents <<<
  68.  
  69.  
  70.      Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  71.  
  72.      Definition of Terms Used in this Document . . . . . . . . . . . . . . .   1
  73.         Access Restriction Flag or AR Flag . . . . . . . . . . . . . . . . .   1
  74.         Download Security Level or DSL . . . . . . . . . . . . . . . . . . .   1
  75.         Program Data or Pdata  . . . . . . . . . . . . . . . . . . . . . . .   1
  76.         Program Key or Pkey  . . . . . . . . . . . . . . . . . . . . . . . .   1
  77.         Security Level or SL . . . . . . . . . . . . . . . . . . . . . . . .   2
  78.         Special Flag or SF . . . . . . . . . . . . . . . . . . . . . . . . .   2
  79.  
  80.      Description of Menu Header Information  . . . . . . . . . . . . . . . .   2
  81.         Menu list number . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  82.         Menu number  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  83.         Menu name  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  84.         Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  85.         General SL . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  86.         AR flag  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  87.         Menu Starting Help Level . . . . . . . . . . . . . . . . . . . . . .   3
  88.         Help file ID . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  89.         Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  90.         Fallback menu  . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  91.  
  92.      Menu location . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  93.         Flags  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  94.            <SL/DSL> access check . . . . . . . . . . . . . . . . . . . . . .   4
  95.            GSL <and/or> AR . . . . . . . . . . . . . . . . . . . . . . . . .   4
  96.            Time/Help <ON/OFF>  . . . . . . . . . . . . . . . . . . . . . . .   4
  97.            Board <NORMAL/ON> . . . . . . . . . . . . . . . . . . . . . . . .   4
  98.            Menu name <NORMAL/PROMPT> . . . . . . . . . . . . . . . . . . . .   4
  99.  
  100.      Description of Command Information  . . . . . . . . . . . . . . . . . .   5
  101.         Command number . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  102.         Long description . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  103.         Short description  . . . . . . . . . . . . . . . . . . . . . . . . .   5
  104.         Key  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  105.         General SL . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  106.         AR flag  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  107.         Program key  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  108.         Program data . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  109.         Flags  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  110.            <SL/DSL> access check . . . . . . . . . . . . . . . . . . . . . .   6
  111.            GSL <and/or> AR . . . . . . . . . . . . . . . . . . . . . . . . .   6
  112.            <Normal/Hidden> Command . . . . . . . . . . . . . . . . . . . . .   6
  113.  
  114.      Sample command  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  115.  
  116.      Predefined Menu Commands Available on All Menus . . . . . . . . . . . .   7
  117.         <space>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  118.         <enter>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  119.         ?  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  120.         \  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  121.         =  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  122.         FALLBACK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  123.  
  124.  
  125.      ===========================================================================
  126.      January, 1993 (Preliminary)                                          Page i
  127.  
  128.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  129.      ===========================================================================
  130.  
  131.                               >>> Table of Contents <<<
  132.  
  133.  
  134.      General Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  135.         Maximum Menus/Commands . . . . . . . . . . . . . . . . . . . . . . .   8
  136.         Executing commands with more than one character  . . . . . . . . . .   8
  137.         Commands with a key of more than one character . . . . . . . . . . .   8
  138.         If commands act strange  . . . . . . . . . . . . . . . . . . . . . .   8
  139.         Default command  . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  140.         Blank Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  141.         AUTOEXEC command . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  142.         Read Message Menu restrictions . . . . . . . . . . . . . . . . . . .   8
  143.         SDR Codes  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  144.         Message Searches . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  145.  
  146.      Command Definition Key  . . . . . . . . . . . . . . . . . . . . . . . .   9
  147.         Text conventions . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  148.            " | " . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  149.            "< ... >" . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  150.            "[ ... ]" . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  151.         Command flags  . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  152.            (*<#>)  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  153.            @ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  154.            @!  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  155.  
  156.      Linked Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  157.         Linked command example . . . . . . . . . . . . . . . . . . . . . . .  10
  158.         How T.A.G. handles link commands . . . . . . . . . . . . . . . . . .  11
  159.  
  160.      Standard Program Keys Available from all Menus  . . . . . . . . . . . .  12
  161.         "!" [@]<Filename>[.Ext]                   Display a text file  . . .  12
  162.         "@" [<User #>]                            Page the SysOp . . . . . .  12
  163.         "#"                                       Change sections  . . . . .  13
  164.         "$"                                       Version Information  . . .  13
  165.         "^" [C]<Menu #>                           Goto another menu  . . . .  13
  166.         "/" [C]<Menu #>                           Gosub another menu   . . .  14
  167.         "\" [C]                                   Return to saved menu . . .  14
  168.         "&"                                       Sysop Status . . . . . . .  14
  169.         "*" [<User #> | I | T]                    Logoff system  . . . . . .  15
  170.         "("                                       Menu information . . . . .  15
  171.         "|" [F]<Section #>                        Change to a section  . . .  16
  172.         "["                                       Search Backward  . . . . .  16
  173.         "]"                                       Search Forward . . . . . .  16
  174.         "0" <Filename>                            Generate random message  .  17
  175.         "1" <A|B|D|F|L|M|P|S|U|V>                 Execute function . . . . .  17
  176.            "A" @ Access validation manager (*3)  . . . . . . . . . . . . . .  17
  177.            "B" @ Message board editor (*2) . . . . . . . . . . . . . . . . .  17
  178.            "D" @ Mini-DOS command system . . . . . . . . . . . . . . . . . .  17
  179.            "F" @ File board editor (*2)  . . . . . . . . . . . . . . . . . .  17
  180.            "L" @ Batch protocol editor (*2)  . . . . . . . . . . . . . . . .  17
  181.            "M" @! Menu editor (*3) . . . . . . . . . . . . . . . . . . . . .  18
  182.            "P" @ Single protocol editor (*2) . . . . . . . . . . . . . . . .  18
  183.            "S" @/@! System configuration editor (*2/*3)  . . . . . . . . . .  18
  184.            "U" @ User log editor (*1)  . . . . . . . . . . . . . . . . . . .  18
  185.            "V" @! Events editor (*2) . . . . . . . . . . . . . . . . . . . .  18
  186.  
  187.  
  188.  
  189.      ===========================================================================
  190.      January, 1993 (Preliminary)                                         Page ii
  191.  
  192.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  193.      ===========================================================================
  194.  
  195.                               >>> Table of Contents <<<
  196.  
  197.  
  198.         "." (*3) @!                               Shell to DOS . . . . . . .  18
  199.         "0" <Key>                                 Execute Command Key  . . .  19
  200.         "9" [M or F][$ or <Group Mask>]           Change Group Mask  . . . .  19
  201.  
  202.      External DOOR Program Keys  . . . . . . . . . . . . . . . . . . . . . .  20
  203.         ":" [@][*]<Filename>  RBBS door program (NEW format) . . . . . . . .  20
  204.         "_" [@][*]<Filename>  RBBS door program (OLD format) . . . . . . . .  20
  205.         "=" [@][*]<Filename>  DOOR.SYS and GAP(tm) door programs . . . . . .  21
  206.         "<" [@][*]<Filename>  Execute a generic door program . . . . . . . .  22
  207.  
  208.      Multinode Program Keys  . . . . . . . . . . . . . . . . . . . . . . . .  23
  209.         "B" [Broadcast]  . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  210.         "M" [Message]  . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  211.         "W" [WhoIsOn]  . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  212.         "C" [Chat] . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  213.  
  214.      Main System Program Keys  . . . . . . . . . . . . . . . . . . . . . . .  24
  215.         "A"                        List message areas  . . . . . . . . . . .  24
  216.         "B"                        Bulletin system . . . . . . . . . . . . .  24
  217.         "C"                        Create auto-message . . . . . . . . . . .  24
  218.         "D" <0..40>                User information functions  . . . . . . .  25
  219.             "0" List user information that can be changed  . . . . . . . . .  25
  220.             "1" Change the user's real name  . . . . . . . . . . . . . . . .  25
  221.             "2" Change the user's address  . . . . . . . . . . . . . . . . .  25
  222.             "3" Change the user's city & state . . . . . . . . . . . . . . .  25
  223.             "4" Change the user's zip code . . . . . . . . . . . . . . . . .  25
  224.             "5" Change the user's phone number . . . . . . . . . . . . . . .  25
  225.             "6" Change the user's computer type  . . . . . . . . . . . . . .  25
  226.             "7" Change the user's ANSI colors  . . . . . . . . . . . . . . .  25
  227.             "8" Change the user's birthday . . . . . . . . . . . . . . . . .  25
  228.             "9" Change the user's highest baud . . . . . . . . . . . . . . .  25
  229.            "10" Change the user's screen size (columns and lines)  . . . . .  25
  230.            "11" Toggle the user's ANSI status  . . . . . . . . . . . . . . .  25
  231.            "12" Toggle the user's color status . . . . . . . . . . . . . . .  25
  232.            "13" Change the user's logon password . . . . . . . . . . . . . .  25
  233.            "14" Change the user's external editor status . . . . . . . . . .  25
  234.            "15" Toggle the user's [PAUSE] status . . . . . . . . . . . . . .  25
  235.            "16" Toggle the user's onekey status  . . . . . . . . . . . . . .  25
  236.            "17" Toggle the user's VT-100 type tab status . . . . . . . . . .  25
  237.            "18" Toggle the user's CLS status . . . . . . . . . . . . . . . .  25
  238.            "19" Change the user's mailbox configuration  . . . . . . . . . .  25
  239.            "20" Change which bases the user new scans  . . . . . . . . . . .  25
  240.            "21" Change menu to logon at (NOT supported)  . . . . . . . . . .  25
  241.            "22" Change the user's help level . . . . . . . . . . . . . . . .  25
  242.            "23" Toggle the user's custom menu status . . . . . . . . . . . .  25
  243.            "24" Toggle the user's clear screen before message status . . . .  25
  244.            "25" Toggle the user's do not disturb status  . . . . . . . . . .  25
  245.            "26" Change the user's phone number 2 . . . . . . . . . . . . . .  25
  246.            "27" Change the user's extra string 1 . . . . . . . . . . . . . .  25
  247.            "28" Change the user's extra string 2 . . . . . . . . . . . . . .  25
  248.            "29" Change the user's extra string 3 . . . . . . . . . . . . . .  25
  249.  
  250.  
  251.  
  252.  
  253.      ===========================================================================
  254.      January, 1993 (Preliminary)                                        Page iii
  255.  
  256.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  257.      ===========================================================================
  258.  
  259.                               >>> Table of Contents <<<
  260.  
  261.  
  262.            "30" Change the user's extra date 1 . . . . . . . . . . . . . . .  25
  263.            "31" Change the user's extra date 2 . . . . . . . . . . . . . . .  25
  264.            "32" Change the user's extra number 1 . . . . . . . . . . . . . .  25
  265.            "33" Change the user's extra number 2 . . . . . . . . . . . . . .  25
  266.            "34" Change the user's extra number 3 . . . . . . . . . . . . . .  25
  267.            "35" Change the user's extra number 4 . . . . . . . . . . . . . .  25
  268.            "36" Change the user's extra character 1  . . . . . . . . . . . .  25
  269.            "37" Change the user's extra character 2  . . . . . . . . . . . .  25
  270.            "38" Change the user's extra character 3  . . . . . . . . . . . .  25
  271.            "39" Change the user's extra character 4  . . . . . . . . . . . .  25
  272.            "40" Change the user's extra phone number . . . . . . . . . . . .  25
  273.         "E"                        Send private mail . . . . . . . . . . . .  26
  274.         "F" <User #>               Feedback  . . . . . . . . . . . . . . . .  26
  275.         "H"                        Reply to author of auto-message . . . . .  26
  276.         "K" [B | C | T]            Scan for messages / Word search . . . . .  27
  277.         "L"                        List matching users . . . . . . . . . . .  27
  278.         "M" [C]                    Scan for messages to the current user . .  27
  279.         "N" [G]                    New scan message sections . . . . . . . .  28
  280.         "O"                        Other bulletin board listing  . . . . . .  28
  281.         "P" [A][R][I]              Post a public message . . . . . . . . . .  28
  282.         "R" [D]                    Word validation and deletion  . . . . . .  29
  283.         "S"                        Scan public messages  . . . . . . . . . .  29
  284.         "U"                        Users with access . . . . . . . . . . . .  29
  285.         "V"                        Voting System . . . . . . . . . . . . . .  29
  286.         "W"                        Read the auto-message . . . . . . . . . .  30
  287.         "X" [N]                    Describe the current message section  . .  30
  288.         "Y"                        Main system user information  . . . . . .  30
  289.         "Z"                        Edit user macros  . . . . . . . . . . . .  31
  290.         "2" @                      Voting initialization system  . . . . . .  31
  291.         "3" (*1) @                 Read all private mail . . . . . . . . . .  31
  292.         "4" @                      View Sysop Logs . . . . . . . . . . . . .  31
  293.         "5" <Password>             Auto user validation  . . . . . . . . . .  32
  294.         "6" @!                     Change the system time and date . . . . .  32
  295.         "7"                        Information on current message section  .  32
  296.         "-"                        System status report  . . . . . . . . . .  33
  297.         ";"                        Execute TAGMAIL   . . . . . . . . . . . .  33
  298.         ">"                        Access the time bank  . . . . . . . . . .  33
  299.         "?" [@]<xxxxx>             Access the questionnaire  . . . . . . . .  34
  300.         "~" [L | O][<Err>][*<#>]   Shut down system  . . . . . . . . . . . .  35
  301.  
  302.      File System Program Keys  . . . . . . . . . . . . . . . . . . . . . . .  36
  303.         "A"                        List File Areas . . . . . . . . . . . . .  36
  304.         "B"                        Browse Files  . . . . . . . . . . . . . .  36
  305.         "C" [U]                    Clear the queue . . . . . . . . . . . . .  36
  306.         "D"                        Download a file . . . . . . . . . . . . .  37
  307.         "E" @                      Exchange directory  . . . . . . . . . . .  37
  308.         "F"                        Find text   . . . . . . . . . . . . . . .  37
  309.         "G"                        Download batch queue  . . . . . . . . . .  38
  310.         "H" [$[?][!]]<Filename>    File Door Call  . . . . . . . . . . . . .  38
  311.         "I" [G | @]                View interior . . . . . . . . . . . . . .  39
  312.         "J"                        Upload batch  . . . . . . . . . . . . . .  39
  313.         "K" [U]                    Remove from a batch queue . . . . . . . .  39
  314.  
  315.  
  316.  
  317.      ===========================================================================
  318.      January, 1993 (Preliminary)                                         Page iv
  319.  
  320.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  321.      ===========================================================================
  322.  
  323.                               >>> Table of Contents <<<
  324.  
  325.  
  326.         "L"                        List files  . . . . . . . . . . . . . . .  40
  327.         "M"                        Users with access . . . . . . . . . . . .  40
  328.         "N" [G | C]                New scan  . . . . . . . . . . . . . . . .  40
  329.         "O" @ [R]                  Unlisted download . . . . . . . . . . . .  41
  330.         "P"                        Change pointer date . . . . . . . . . . .  41
  331.         "Q" [U]                    List queue  . . . . . . . . . . . . . . .  41
  332.         "R"                        Remove files  . . . . . . . . . . . . . .  42
  333.         "S"                        Scan for files  . . . . . . . . . . . . .  42
  334.         "T"                        Type a file . . . . . . . . . . . . . . .  42
  335.         "U"                        Upload a file . . . . . . . . . . . . . .  43
  336.         "V" @ [G]                  Validate files  . . . . . . . . . . . . .  43
  337.         "W" @ [R]                  Raw Directory . . . . . . . . . . . . . .  43
  338.         "X" [N]                    Describe section  . . . . . . . . . . . .  44
  339.         "Y"                        File system user information  . . . . . .  44
  340.         "Z"                        Set new scan  . . . . . . . . . . . . . .  44
  341.         "2" @                      Sort files  . . . . . . . . . . . . . . .  45
  342.         "3" @                      Edit files  . . . . . . . . . . . . . . .  45
  343.         "4" @                      Move files  . . . . . . . . . . . . . . .  45
  344.         "5"                        List section information  . . . . . . . .  45
  345.         "6" @!                     Change active directory . . . . . . . . .  46
  346.  
  347.      Read Message Menu Program Keys  . . . . . . . . . . . . . . . . . . . .  47
  348.         "A"                        Read current message again  . . . . . . .  47
  349.         "C"                        Continuous read of messages . . . . . . .  47
  350.         "D"                        Default next message  . . . . . . . . . .  48
  351.         "I"                        Ignore messages and go to next section  .  48
  352.         "K"                        Kludge/technical information on message .  48
  353.         "N"                        Next message section  . . . . . . . . . .  48
  354.         "P" [A][R][I]              Post message in current section . . . . .  49
  355.         "Q"                        Quit read message menu  . . . . . . . . .  49
  356.         "R" [A][R][E or P]         Reply to current message  . . . . . . . .  49
  357.         "S"                        Subjects of next few messages . . . . . .  50
  358.         "T"                        Toggle scan setting of current section  .  50
  359.         "U"                        User info - current message author  . . .  50
  360.         "V"                        Validate author of current message  . . .  50
  361.         "W"                        Write current message to file/printer . .  51
  362.         "Z"                        Delete current message  . . . . . . . . .  51
  363.         "+"                        Next message in thread  . . . . . . . . .  51
  364.         "-"                        Previous message in thread  . . . . . . .  52
  365.         "7"                        Information on the current message base .  52
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.      ===========================================================================
  382.      January, 1993 (Preliminary)                                          Page v
  383.  
  384.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  385.      ===========================================================================
  386.  
  387.  
  388.                                     /============\
  389.                                    < Introduction >
  390.                                     \============/
  391.       
  392.      The best way to look at the menu  system is from the point of a  programmer
  393.      as it could be  seen as a mini-programming language. If  you plan to create
  394.      your own menu system from scratch, I highly advise planning it out on paper
  395.      first  or it is very  likely that your  prized creation will  turn out much
  396.      less  organized than you had  planned. By planning,  it is meant completely
  397.      define your  menus and the  commands which will  go under them,  before you
  398.      start. 
  399.       
  400.      The menu  editor is set up into  four levels. First, you  see all the menus
  401.      you  currently have  defined and  their numbers.  Secondly, after  choosing
  402.      which  menu to  edit, you see  the header  information for  that menu which
  403.      includes the name, prompt, security definition, and various other flags and
  404.      values. Thirdly, when entering the  command editor for the menu, you  see a
  405.      list of commands currently defined under the chosen  menu and their number.
  406.      Finally you  choose and edit the definition  of each command which includes
  407.      the menu display  information, security definition,  operation programming,
  408.      and various other flags and values. 
  409.       
  410.      Take  a look at  the menu system provided  with the start  up package for a
  411.      working  example. There  is no  need to  create a  new menu  system  to run
  412.      T.A.G., the menu  editor on most systems is only used to vary access on the
  413.      commands. Later when you become  more comfortable with the system,  you may
  414.      choose to create your own menu setup. 
  415.       
  416.                      /=========================================\ 
  417.                     < Definition of Terms Used in this Document > 
  418.                      \=========================================/ 
  419.  
  420.      Access Restriction Flag or AR Flag: 
  421.         A letter from  "A" to "Z"  indicating what  special privilege an  object
  422.         (whether  it be a menu, a  command, or a user) holds.  Users must have a
  423.         particular AR  flag set  in  order for  a function  depending  on it  to
  424.         operate. An AR  flag setting of "@"  on an object  indicates no AR  flag
  425.         check is performed. 
  426.       
  427.      Download Security Level or DSL: 
  428.         A  number from  0 to  255 representing  what level  of access  an object
  429.         (whether it  be a menu, a  command, or a  user), usually related  to the
  430.         file transfer system, holds. Users must  have an equal of higher DSL for
  431.         a function depending on it to operate. 
  432.       
  433.      Program Data or Pdata: 
  434.         A  string of  characters representing  special information  a particular
  435.         program key may need in order to properly operate. 
  436.       
  437.      Program Key or Pkey: 
  438.         A letter, number, or symbol identifying the specific operation a command
  439.         is supposed to perform. 
  440.  
  441.  
  442.  
  443.  
  444.  
  445.      ===========================================================================
  446.      January, 1993 (Preliminary)                                          Page 1
  447.  
  448.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  449.      ===========================================================================
  450.  
  451.  
  452.      Security Level or SL: 
  453.         A number  from 0 to  255 representing  what primary level  of access  an
  454.         object (whether it be  a menu, a command,  or a user) holds. Users  must
  455.         have an equal or higher SL for a function depending on it to operate. 
  456.       
  457.      Special Flag or SF: 
  458.         A letter from "A" to "X" that represents a set function  with respect to
  459.         a  user. See  the table  of special  flag functions  in the  main T.A.G.
  460.         documentation for more details.
  461.  
  462.                       /======================================\ 
  463.                      < Description of Menu Header Information > 
  464.                       \======================================/ 
  465.       
  466.      Menu list number: 
  467.         This field  is for display  only and indicates  the list number  of each
  468.         menu. The  editing functions use this  number as menu numbers  can be in
  469.         any random order.
  470.  
  471.      Menu number: 
  472.         This field is  a number from  1 to 255  used as a  reference from or  to
  473.         other menus  with the goto and  gosub commands. This number  need not be
  474.         the same as the menu list number.
  475.  
  476.      Menu name: 
  477.         This field is the name or title  of the menu displayed on the novice and
  478.         normal  help levels. If custom help menus  are being used for the novice
  479.         and  normal  help  levels  this   field  is  never  displayed.  Standard
  480.         "Control-P  <Color 0-9>" colors  are allowed in the  menu name, but they
  481.         will decrease the allowed number of characters. 
  482.  
  483.      Prompt: 
  484.         This field is the last thing printed by T.A.G. on any  help level before
  485.         waiting  for  input  from  the  user  (e.g.  "Main  Menu:  ").  Standard
  486.         "Control-P <Color 0-9>" colors are allowed in the prompt,  but they will
  487.         decrease the allowed number of characters. 
  488.  
  489.      General SL: 
  490.         This  field is the general security level  which specifies the SL or DSL
  491.         used to check  access for a menu.  How the GSL is used  is determined by
  492.         the flag settings. 
  493.  
  494.      AR flag: 
  495.         This field is the  AR flag used to check  access for a menu. How  the AR
  496.         flag is used is determined by the flag settings. 
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.      ===========================================================================
  510.      January, 1993 (Preliminary)                                          Page 2
  511.  
  512.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  513.      ===========================================================================
  514.  
  515.  
  516.      Menu Starting Help Level:
  517.         The starting help level can contain either a zero or a value from one to
  518.         four.  Zero means the user starts at the help level s/he has  defined as
  519.         their default help level, while a number from one to four indicates that
  520.         the user is forced to a specific help level no matter what their default
  521.         setting is.  Normally  most menus will be set to  zero, however the read
  522.         message  menu, for example, is often set to  "2" or "1" to eliminate the
  523.         large menus for new users between messages.
  524.  
  525.      Help file ID: 
  526.         This field specifies a  7 character filename prefix for  customized help
  527.         menus  on a T.A.G. system; the field  is blank when customized menus are
  528.         not being  used. The prefix is  followed by a "2" (Key  help level), "3"
  529.         (Abbreviated  help level), or "4" (Full command help level) depending on
  530.         which help level the file represents. Help level "1" (Expert help level)
  531.         does not have a file because  that level is characteristic of not having
  532.         menus. Partial customizing is  possible by only including the  menu help
  533.         files  you wish to replace; T.A.G. will automatically generate menus for
  534.         any customizing files it cannot find. Customizing files should be placed
  535.         in the Alternate Text File Directory. 
  536.       
  537.         For example,  setting the help  file ID to  "MAIN" will cause  T.A.G. to
  538.         look for the following files: 
  539.  
  540.            MAIN2.MSG - Key help level (help level 2). 
  541.            MAIN3.MSG - Abbreviated help level (help level 3). 
  542.            MAIN4.MSG - Full command help level (help level 4). 
  543.  
  544.         In addition  to the above, ANSI help menus are supported. Just include a
  545.         "*.CLR" version of  the above files  and it will  be used  automatically
  546.         when  appropriate for the user currently on-line. It is also possible to
  547.         just  include "*.CLR" help files  and allow T.A.G.  to generate standard
  548.         text files for non-ANSI users. 
  549.  
  550.         T.A.G. also  supports custom menus by  security level.  To  create an SL
  551.         specific  menu, you  just append  a -<SL> to  the file  name.   The only
  552.         problem is  that you may need  to shorten your MENU  names to accomplish
  553.         this, since "MAIN1-255" is  one character too long!   But "MAI1-255"  is
  554.         just  right.An SL specific custom menu overrides the normal custom menu.
  555.         If "MAI3-100.CLR"  and "MAI3.CLR" both exist,  a user with an  SL of 100
  556.         will see the "MAI3-100" at help level 3.
  557.  
  558.      Password: 
  559.         This field specifies an optional password required for access to a menu.
  560.         If  a password is specified, and it  is incorrectly entered by the user,
  561.         s/he is sent to the fallback menu specified. It is not advisable to have
  562.         a password on  a menu with  a fallback  pointer of zero,  as that  would
  563.         disconnect the user if incorrectly entered. 
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.      ===========================================================================
  574.      January, 1993 (Preliminary)                                          Page 3
  575.  
  576.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  577.      ===========================================================================
  578.  
  579.  
  580.      Fallback menu: 
  581.         This field specifies the menu which the system will go back to when some
  582.         type  of error occurs. Possible errors include no commands being defined
  583.         on a  menu, a corrupted menu  file, incorrect password entry,  or a user
  584.         not having  access to  a menu.  A fallback menu  of zero  will send  the
  585.         system into a fatal error state, logging the user off  and returning the
  586.         system to the wait screen to wait for the next caller.
  587.  
  588.      Menu location: 
  589.         This  field specifies  to which  of systems,  the main system,  the file
  590.         system, or  the read message system  the menu belongs. T.A.G.  uses this
  591.         information to automatically load the proper system when changing menus.
  592.  
  593.      Flags: 
  594.  
  595.      <SL/DSL> access check: 
  596.         This flag determines whether T.A.G.  will use the SL  or the DSL of  the
  597.         user  to compare  against the  GSL defined  in the  menu for  the access
  598.         check. 
  599.  
  600.      GSL <and/or> AR: 
  601.         This flag determines how T.A.G. will use the GSL and AR flag combination
  602.         to determine a users access to the current menu. 
  603.  
  604.         The two possible settings are: 
  605.            * "GSL and AR" indicates  the user must satisfy the  general security
  606.            level AND have the AR flag specified in order to use the menu. 
  607.  
  608.            *  "GSL or AR"  indicates the user must  satisfy the general security
  609.            level OR have the AR flag specified in order to use the menu. 
  610.  
  611.      Time/Help <ON/OFF>: 
  612.         This flag determines whether  the "Time left: 00:00:00  ("?"=Help)" line
  613.         is displayed along with the menu prompt when a user is at this menu. 
  614.  
  615.      Board <NORMAL/ON>: 
  616.         This  flag determines  whether the  current message  or file  section is
  617.         force displayed along with the menu prompt when a user  is at this menu.
  618.         Normally the current message or file section name is only displayed when
  619.         the user has the option to change sections. 
  620.  
  621.      Menu name <NORMAL/PROMPT>: 
  622.         This flag determines  whether a special long prompt system is used. When
  623.         active, the  menu name becomes  the prompt  field and the  normal prompt
  624.         field is no longer active. Having a menu name when this is active is not
  625.         possible, of course. 
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.      ===========================================================================
  638.      January, 1993 (Preliminary)                                          Page 4
  639.  
  640.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  641.      ===========================================================================
  642.  
  643.  
  644.                         /==================================\ 
  645.                        < Description of Command Information > 
  646.                         \==================================/ 
  647.  
  648.      Command number: 
  649.         This field is for display only and indicates the command  number used as
  650.         a reference point for the editing functions. 
  651.  
  652.      Long description: 
  653.         This field contains the full description of a command's operation. It is
  654.         used when T.A.G. generates a full help menu (help level 4). Obviously if
  655.         your  system has custom help menus for  this help level, this field will
  656.         never be  displayed. Standard "Control-P <Color 0-9>" colors are allowed
  657.         in the long description,  but they will  decrease the allowed number  of
  658.         characters. 
  659.  
  660.      Short description: 
  661.         This field contains an abbreviated description of a command's operation.
  662.         It is used when T.A.G. generates  a normal help menu, lists the commands
  663.         in  the menu  editor, and  lists the commands  when menu  information is
  664.         requested. Standard "Control-P  <Color 0-9>" colors  are allowed in  the
  665.         short  description,  but  they  will  decrease  the  allowed  number  of
  666.         characters. 
  667.  
  668.      Key: 
  669.         This field indicates what the  user must type in order to  activate this
  670.         command. Keys  over one  character in  length can  only be activated  by
  671.         proceeding them  with "//" unless the  line input entry mode  is chosen.
  672.         Special  exceptions to  this  rule include  number  keys and  those  two
  673.         character keys beginning with "/", such as "/G". This field is also used
  674.         to generate the key help level menu. 
  675.  
  676.      General SL: 
  677.         This field is  the general security level which specifies  the SL or DSL
  678.         used to check access for a command. How the GSL is used is determined by
  679.         the flag settings. 
  680.  
  681.      AR flag: 
  682.         This field is the AR flag used to check access for a command. How the AR
  683.         flag is used is determined by the flag settings. 
  684.  
  685.      Program key: 
  686.         This field is  an operation indicating to T.A.G. what action the command
  687.         performs. It is a single character from the one of the three program key
  688.         tables later in this document. Please note that the location of the menu
  689.         determines  which program keys are  valid. File system  program keys are
  690.         not active in the main system, and vise versa. Do not confuse this field
  691.         with the "Key" field, it has nothing to do with what  the user enters in
  692.         order to activate the command. 
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.      ===========================================================================
  702.      January, 1993 (Preliminary)                                          Page 5
  703.  
  704.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  705.      ===========================================================================
  706.  
  707.  
  708.      Program data: 
  709.         This field specifies any additional information a particular program key
  710.         may  need in  order to  operate. It  may contain  a file  name, optional
  711.         special feature indicators, or  many other things. Many commands  do not
  712.         require any program data, others function in differing ways depending on
  713.         whether program  data is present.  See the  program key tables  later in
  714.         this document for more information.
  715.  
  716.      Flags: 
  717.  
  718.      <SL/DSL> access check: 
  719.         This  flag determines whether T.A.G. will  use the SL or  the DSL of the
  720.         user to  compare against the GSL  defined in the command  for the access
  721.         check. 
  722.  
  723.      GSL <and/or> AR: 
  724.         This flag determines how T.A.G. will use the GSL and AR flag combination
  725.         to  determine a users  access to the  current command.  The two possible
  726.         settings are: 
  727.  
  728.         *  "GSL and  AR" indicates  the user  must satisfy the  general security
  729.         level AND have the AR flag specified in order to use the command. 
  730.  
  731.         * "GSL or AR" indicates the user must satisfy the general security level
  732.         OR have the AR flag specified in order to use the command. 
  733.  
  734.      <Normal/Hidden> Command:
  735.         This field determines  what command  will appear on  a T.A.G.  generated
  736.         menu.  Hidden commands appear  on the menu information  list if the user
  737.         has SysOp access or greater.
  738.  
  739.                                    /==============\
  740.                                   < Sample command >
  741.                                    \==============/
  742.  
  743.      Command number  : 26 
  744.      1. Long desc.   : (/U)ser log editor and manager. 
  745.      2. Short desc.  : (/U)ser Edit   
  746.      3. Key          : /U 
  747.      4. General SL   : 250   
  748.      5. AR level     : Z 
  749.      6. Program key  : 1 
  750.      7. Program data : U 
  751.      8. Flags        : SL access check, GSL or AR, Hidden Command 
  752.  
  753.      This command is activated by typing "/U" from the menu (as  defined in line
  754.      #3). It is available to users with a SL of 250 <<OR>> the 'Z' AR flag.  The
  755.      program key  "1" specifies a specific  function to T.A.G.,  and the program
  756.      data specifies the  user log editor. This command is hidden  so it will not
  757.      appear on T.A.G. generated menus. Please notice the danger with "GSL or AR"
  758.      commands. A user with a SL of 10 could conceivably enter the user editor if
  759.      their  'Z' flag  is set.  Of course  the automatic  protection in  the user
  760.      editor will prevent anyone with  SL 10 from changing much, but  the problem
  761.      still exists.
  762.  
  763.  
  764.  
  765.      ===========================================================================
  766.      January, 1993 (Preliminary)                                          Page 6
  767.  
  768.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  769.      ===========================================================================
  770.  
  771.  
  772.                   /===============================================\ 
  773.                  < Predefined Menu Commands Available on All Menus > 
  774.                   \===============================================/ 
  775.  
  776.      Key      Description 
  777.      -------  --------------------------------------------------------------- 
  778.      <space>  Reprint the current menu at the current help level. 
  779.  
  780.      <enter>  (Same  as  space) Reprint  the current  menu  at the  current help
  781.               level.
  782.  
  783.      ?        If user is at help level 1 (no help), this command will raise them
  784.               to help  level three on  this menu, otherwise it  will advance the
  785.               user forward one help level (if possible) and reprint the menu. 
  786.  
  787.      \        Display  the version and  possible registration  information about
  788.               the T.A.G. system currently running. 
  789.  
  790.      =        When a user has a SL of  at least CoSysOp level, this command will
  791.               display the current menu stack  and print all accessible  commands
  792.               along with the menu information about each. Note: Hidden  commands
  793.               will ONLY appear in this list if the user performing the operation
  794.               has SysOp access or above.  AUTOEXEC commands NEVER show on a menu
  795.               stack dump.
  796.  
  797.      FALLBACK Falls back  to the  programmed fallback menu.  Note: This  command
  798.               will not function when the fallback menu is defined as zero. 
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.      ===========================================================================
  830.      January, 1993 (Preliminary)                                          Page 7
  831.  
  832.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  833.      ===========================================================================
  834.  
  835.  
  836.                                    /=============\ 
  837.                                   < General Notes > 
  838.                                    \=============/ 
  839.  
  840.      Maximum Menus/Commands
  841.         The maximum number of menus is 100.  
  842.         The maximum number of commands per menu is 100.
  843.  
  844.      Executing commands with more than one character
  845.         To execute  Commands with  a key of  more than one  character, excluding
  846.         numbers  and  those two  character commands  beginning  with one  of the
  847.         programmable command  characters, such as "/" (i.e."/G"),  the user must
  848.         precede them with  "//" at the menu prompt (e.g.  "//LOG" to execute the
  849.         LOG command). 
  850.  
  851.      If commands act strange
  852.         If a menu's Commands are acting strange, such as the bulletin command is
  853.         doing a file section browse  instead, you have your menu location  field
  854.         set to  the wrong value. Main  system program keys will  not function in
  855.         the file section, as file  system program keys will not function  in the
  856.         main system.
  857.  
  858.      Default command
  859.         A default  command feature is  available which will  be executed  if the
  860.         user should  simply press carriage  return at a  menu.  Simply  define a
  861.         command with  the command key of  "<CR>" (without quotes  of course) and
  862.         that  command will be executed  when the users  pressed carriage return.
  863.         The best example of a use of this feature would be the  reading messages
  864.         menu, where it is  often desirable to have a carriage return take you to
  865.         the next message.
  866.  
  867.      Blank Keys
  868.         Commands with  a blank Command  Key do  not display on  T.A.G. generated
  869.         menus.  Blanking  the command key on link command  will save the trouble
  870.         of having to "Hide" each of the commands in a link chain.
  871.  
  872.      AUTOEXEC command
  873.         T.A.G.  allows automatic  execution  of a  command  whenever a  menu  is
  874.         loaded.  To enable this function, the FIRST command key (even before the
  875.         #  command) must  be "AUTOEXEC".  The AUTOEXEC  command can  have linked
  876.         commands. Auto executing commands are not displayed on the menu.
  877.  
  878.      Read Message Menu restrictions
  879.         If  a menu has a  location of "Read Message System",  you cannot GOTO or
  880.         GOSUB menus with any  other location.  The quit command  (Pkey="Q") must
  881.         be used  to exit these  menus. Additionally, it  is imperative  that you
  882.         define a default "Read Message Menu" in your system configuration.
  883.  
  884.      SDR Codes
  885.         The menu name and prompt fields may contain SDR codes.
  886.  
  887.      Message Searches
  888.         All message  searches use the users  Real Name and Handle  except in the
  889.         private Email area.
  890.  
  891.  
  892.  
  893.      ===========================================================================
  894.      January, 1993 (Preliminary)                                          Page 8
  895.  
  896.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  897.      ===========================================================================
  898.  
  899.  
  900.                               /======================\ 
  901.                              < Command Definition Key > 
  902.                               \======================/ 
  903.  
  904.                                   /================\
  905.                                  < Text conventions >
  906.                                   \================/
  907.       
  908.      " | "       OR operator which separates two or more items where only one of
  909.                  those items may appear in the program data at any one time. For
  910.                  example "<User #> | I  | T" would be replaced by exactly one of
  911.                  the following: A  user number,  the letter "I",  or the  letter
  912.                  "T". 
  913.       
  914.      "< ... >"   Description of  a value  which should replace  this expression.
  915.                  For example  "<User #>" would  be replaced  by the  appropriate
  916.                  user number. 
  917.       
  918.      "[ ... ]"   An optional  item that may or may  not be included depending on
  919.                  the intended use. 
  920.  
  921.                                    /=============\
  922.                                   < Command flags >
  923.                                    \=============/
  924.       
  925.      (*<#>)      Indicates the command requires  the specified SysOp password in
  926.                  order to be used. 
  927.       
  928.      @        Indicates this command should  restricted to privileged users such
  929.               as your lower level remote SysOps. 
  930.       
  931.      @!       Indicates this command could be very  dangerous in the hands of  a
  932.               user with harmful  intent. Only those  users you trust  completely
  933.               should be given access to these commands. 
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.      ===========================================================================
  958.      January, 1993 (Preliminary)                                          Page 9
  959.  
  960.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  961.      ===========================================================================
  962.  
  963.  
  964.                                   /===============\
  965.                                  < Linked Commands >
  966.                                   \===============/
  967.  
  968.      Each command  contains a flag which  indicates whether it is  linked to the
  969.      next command or  not.  If the  flag is active, the  system will immediately
  970.      execute  the next command on the menu without prompting the user.  Up to 20
  971.      commands  may be in  the link buffer  at any one  time.  This  means that a
  972.      single command could have 20 linked commands attached to it.
  973.  
  974.      Normally when  creating a linked set of commands, only the first command is
  975.      executable by the user.  T.A.G. will allow linking into other real commands
  976.      (which the  user can press  a "key"  for), but unless  you have  a specific
  977.      reason for  doing so,  all other commands  in a chain  should have  a blank
  978.      "key" field.
  979.  
  980.      If a linked command should  change system locations (e.g. go into  the file
  981.      section), all  commands  in the  chain  from  that point  forward  will  be
  982.      executed using the Pkey/Pdata definitions in that location.  An  example of
  983.      this would be creating a command on the main menu which first does a "goto"
  984.      to the file system, and then executes the download command.
  985.  
  986.      If  the  system  encounters  a  command in  the  link  chain  which  is not
  987.      accessible to the user, the link buffer is immediately cleared and the user
  988.      will be dropped at whatever menu is currently active.
  989.  
  990.                                /======================\
  991.                               < Linked command example >
  992.                                \======================/
  993.  
  994.      When  creating a  set of  linked commands,  the last  command in  the chain
  995.      should NOT have the link flag set.  For example, to create a 3 command link
  996.      chain, they would be set up as follows:
  997.  
  998.         Command 1:
  999.         |  Key = Command user must type to execute
  1000.         |  Pkey/Pdata = Program information of first command
  1001.         |  Flag = Linked to Next
  1002.         |
  1003.         Command 2:
  1004.         |  Key = Blank
  1005.         |  Pkey/Pdata = Program information of second command
  1006.         |  Flag = Linked to Next
  1007.         |
  1008.         Command 3:
  1009.         |  Key = Blank
  1010.         |  Pkey/Pdata = Program information of third command
  1011.         |  Flag = No Linking
  1012.  
  1013.      The  existence  of the  global  command  "Execute Command  Key"  (Pkey="0";
  1014.      Pdata=<KEY>) should  be noted  as  it provides  an easy  way  to limit  the
  1015.      duplication of access levels in multiple linked commands.  See that command
  1016.      for more information.
  1017.  
  1018.  
  1019.  
  1020.  
  1021.      ===========================================================================
  1022.      January, 1993 (Preliminary)                                         Page 10
  1023.  
  1024.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1025.      ===========================================================================
  1026.  
  1027.  
  1028.                           /================================\
  1029.                          < How T.A.G. handles link commands >
  1030.                           \================================/
  1031.  
  1032.      When  the user executes  a command which  has other commands  linked to it,
  1033.      T.A.G. first copies all of the linked  commands into a link buffer and then
  1034.      executes the first command in the chain.  
  1035.  
  1036.      Upon returning to any standard menu, the system  will first check to see if
  1037.      there are any commands  in the link buffer.   If so, the first one  will be
  1038.      pulled out  of the buffer and executed.   This process is repeated until no
  1039.      commands exist in the link buffer.
  1040.  
  1041.      In the case of the  "Execute Command Key" command, if the  command executed
  1042.      contains linked commands itself, they  are added to the link  buffer before
  1043.      any remaining  commands from the original  link.  Thus the  commands in the
  1044.      executed command will  be processed before continuing with the  link of the
  1045.      original command.
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.      ===========================================================================
  1086.      January, 1993 (Preliminary)                                         Page 11
  1087.  
  1088.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1089.      ===========================================================================
  1090.  
  1091.  
  1092.                   /==============================================\ 
  1093.                  < Standard Program Keys Available from all Menus > 
  1094.                   \==============================================/ 
  1095.  
  1096.            /=============================================================\
  1097.           < "!" [@]<Filename>[.Ext]                   Display a text file >
  1098.            \=============================================================/
  1099.  
  1100.      Function :  Display a text file 
  1101.      Pkey     :  "!" 
  1102.      Pdata    :  [@]<Filename>[.<Ext>] 
  1103.  
  1104.      [@]            Indicates  the  file  resides  in the  Alternate  Text  File
  1105.                     Directory instead of the Main Data File Directory. 
  1106.      <Filename>     MS-DOS filename of the file to be printed. 
  1107.      .<Ext>         Optional MS-DOS extension, if not ".MSG" and/or ".CLR". 
  1108.  
  1109.      This  command displays a text file located  in the Main Data File Directory
  1110.      unless otherwise specified  by the Pdata.  If an extension is  not included
  1111.      with the filename, T.A.G.  will assume the standard "*.MSG"  and/or "*.CLR"
  1112.      system.  That is, if a "*.CLR" version  exists and the user's ANSI graphics
  1113.      are active, then it is displayed, otherwise the "*.MSG" is displayed.
  1114.  
  1115.      If the  multi-user option is  active, the system  will scan  the multi-user
  1116.      directory for the file if it cannot be found in the local directories.
  1117.  
  1118.               /========================================================\
  1119.              < "@" [<User #>]                            Page the SysOp >
  1120.               \========================================================/
  1121.  
  1122.      Function:   Page the SysOp 
  1123.      Pkey:    "@" 
  1124.      Pdata:      [<User #>] 
  1125.  
  1126.      [<User #>]  User number  to whom the message  is left to when  the SysOp is
  1127.                  not available. Note: Option only available in the main system. 
  1128.  
  1129.      This command  requests to chat  with the  SysOp by having  him/her enter  a
  1130.      short reason, and then paging the operator at the keyboard. If sysop status
  1131.      is set to "Available"  or if the user types the chat  password as the first
  1132.      part  of the chat reason, a visual and  audio page will occur. If the SysOp
  1133.      is  not available of fails to respond  to the page, an optional message can
  1134.      be left to the user specified in the Pdata. 
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.      ===========================================================================
  1150.      January, 1993 (Preliminary)                                         Page 12
  1151.  
  1152.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1153.      ===========================================================================
  1154.  
  1155.  
  1156.              /=========================================================\
  1157.             < "#"                                       Change sections >
  1158.              \=========================================================/
  1159.  
  1160.      Function :  Change message section, message number, or file section
  1161.      Pkey     :  "#" 
  1162.      Pdata    :  None
  1163.  
  1164.      This  command allows  user to  change messages or  sections in  the current
  1165.      system  by  entering  a  number.   The  command  has  the  following action
  1166.      depending on the menu location:
  1167.  
  1168.      Location             Action
  1169.      -------------------  ----------------------
  1170.      Main System          Change Message Section
  1171.      Read Message System  Change Message Number
  1172.      File System          Change File Section
  1173.  
  1174.      NOTE: With the exception of the AUTOEXEC command, this command MUST  be the
  1175.            first command on the menu, but may be hidden if it causes a problem. 
  1176.  
  1177.            /=============================================================\
  1178.           < "$"                                       Version Information >
  1179.            \=============================================================/
  1180.  
  1181.      Function:   Version information 
  1182.      Pkey:       "$" 
  1183.      Pdata:      None 
  1184.  
  1185.      This command prints  the current T.A.G.  version and possible  registration
  1186.      information. 
  1187.  
  1188.             /===========================================================\
  1189.            < "^" [C]<Menu #>                           Goto another menu >
  1190.             \===========================================================/
  1191.  
  1192.      Function:   Goto another menu
  1193.      Pkey:       "^"
  1194.      Pdata:      [C]<Menu #>
  1195.  
  1196.      [C]         Clear the menu stack before changing menus. 
  1197.      <Menu #>    Number of the menu to send the user to. 
  1198.  
  1199.      This command changes to the menu number indicated in the Pdata. 
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.      ===========================================================================
  1214.      January, 1993 (Preliminary)                                         Page 13
  1215.  
  1216.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1217.      ===========================================================================
  1218.  
  1219.  
  1220.             /============================================================\
  1221.            < "/" [C]<Menu #>                           Gosub another menu >
  1222.             \============================================================/
  1223.  
  1224.      Function:   Gosub another menu (remember current menu and goto another) 
  1225.      Pkey:       "/" 
  1226.      Pdata:      [C]<Menu #>
  1227.       
  1228.      [C]         Clear the menu stack before changing menus. 
  1229.      <Menu #>    Number of the menu to send the user to. 
  1230.  
  1231.      This command first  saves the current  menu number on  the menu stack,  and
  1232.      then changes to the menu number indicated in the Pdata. A later command may
  1233.      now exist  to return  to the previous  menu (the menu  number saved  on the
  1234.      stack). The  "=" command  can  be used  to find  problems  with menu  stack
  1235.      commands  as it  prints out  the  current menu  stack in  addition to  menu
  1236.      command information. 
  1237.       
  1238.            /==============================================================\
  1239.           < "\" [C]                                   Return to saved menu >
  1240.            \==============================================================/
  1241.  
  1242.      Function:   Return to previously saved menu in menu stack 
  1243.      Pkey:       "\" 
  1244.      Pdata:      [C]
  1245.  
  1246.      [C]         After returning, clear the menu stack.
  1247.  
  1248.      This  command returns to  the most recently  saved menu number  on the menu
  1249.      stack.  The  "=" command  can  be used  to  find problems  with  menu stack
  1250.      commands as it displays the current  menu stack in addition to menu command
  1251.      information. 
  1252.  
  1253.                /======================================================\
  1254.               < "&"                                       Sysop Status >
  1255.                \======================================================/
  1256.  
  1257.      Function:   SysOp status 
  1258.      Pkey:       "&" 
  1259.      Pdata:      None 
  1260.  
  1261.      This  command checks the status of the  SysOp chat call. Basically it tells
  1262.      the  user whether  it is  on or  off. The  optional files  "CHATON.MSG" and
  1263.      "CHATOFF.MSG" may be used for customization, see their descriptions. 
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.      ===========================================================================
  1278.      January, 1993 (Preliminary)                                         Page 14
  1279.  
  1280.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1281.      ===========================================================================
  1282.  
  1283.  
  1284.               /=======================================================\
  1285.              < "*" [<User #> | I | T]                    Logoff system >
  1286.               \=======================================================/
  1287.  
  1288.      Function:   Logoff system 
  1289.      Pkey:       "*" 
  1290.      Pdata:      [<User #> | I | T] 
  1291.  
  1292.      <BLANK>  The user will be  asked if they are  sure they wish to  logoff the
  1293.               system. If so T.A.G. will display the logoff message and hangup. 
  1294.  
  1295.      <User #> The  user will be asked if  they are sure they  wish to logoff the
  1296.               system, then  whether they wish  to leave  a comment  to the  user
  1297.               specified in the Pdata. Afterwards  T.A.G. will display the logoff
  1298.               message and hangup. NOTE:  This option is only available  from the
  1299.               main system.  If used in the  file system it will  function as the
  1300.               <BLANK> option. 
  1301.  
  1302.      "I"         Instant  hangup. Nothing  else will  be displayed,  T.A.G. will
  1303.                  simply hangup. 
  1304.  
  1305.      "T"         Text file  only. T.A.G.  will display  the  logoff message  and
  1306.                  hangup. 
  1307.  
  1308.      This command logs the user off the system. 
  1309.  
  1310.      NOTE:
  1311.         It is  NOT possible  to leave  a logoff message  from the  file transfer
  1312.         system. It  is possible however to create a sub-menu located in the main
  1313.         system  where the  normal logoff  sequence could  be simulated  though a
  1314.         series  of commands. All (G)oodbye commands would GOSUB this menu and if
  1315.         a user aborted the logoff,  it would simply RETURN to the  previous menu
  1316.         where they were located.
  1317.  
  1318.              /==========================================================\
  1319.             < "("                                       Menu information >
  1320.              \==========================================================/
  1321.  
  1322.      Function:   Menu information 
  1323.      Pkey :      "(" 
  1324.      Pdata :     None 
  1325.  
  1326.      This command will display the current  menu stack and print all  accessible
  1327.      commands along with the menu information defined for each. 
  1328.  
  1329.      Note: Hidden commands will ONLY appear on this list if  the user performing
  1330.            the operation has SysOp access or above. This is a definable "=" key.
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.      ===========================================================================
  1342.      January, 1993 (Preliminary)                                         Page 15
  1343.  
  1344.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1345.      ===========================================================================
  1346.  
  1347.  
  1348.            /=============================================================\
  1349.           < "|" [F]<Section #>                        Change to a section >
  1350.            \=============================================================/
  1351.  
  1352.      Function :  Change to a specific message section or file section
  1353.      Pkey     :  "|"
  1354.      Data     :  <Section #>
  1355.  
  1356.      <Section #> The number of section which to change to.
  1357.  
  1358.      This  command changes  to  the message  or file  section  specified in  the
  1359.      program  data.  The command has the  following action depending on the menu
  1360.      location:
  1361.  
  1362.      Location             Action
  1363.      -------------------  ----------------------
  1364.      Main System          Change Message Section
  1365.      Read Message System  Invalid 
  1366.      File System          Change File Section
  1367.  
  1368.      The section  number specified  MUST be  the real  section  number, not  the
  1369.      dynamic  one.  Normal access  checks are done by the  system so that if the
  1370.      user does not have access to the section, the change request will fail.
  1371.  
  1372.              /=========================================================\
  1373.             < "["                                       Search Backward >
  1374.              \=========================================================/
  1375.  
  1376.      Function :  Search backward  for next  accessible message section,  message
  1377.                  number, or file section 
  1378.      Pkey     :  "[" 
  1379.      Pdata    :  None
  1380.  
  1381.      This command  will search backward (lower  numbered sections/messages) from
  1382.      the  current section/message  for the  next accessible  section/message. If
  1383.      none is found, the user will remain in the current section/message. 
  1384.  
  1385.               /========================================================\
  1386.              < "]"                                       Search Forward >
  1387.               \========================================================/
  1388.  
  1389.      Function :  Search  forward  for next  accessible message  section, message
  1390.                  number, or file section 
  1391.      Pkey     :  "]" 
  1392.      Pdata    :  None
  1393.  
  1394.      This command  will search forward (higher  numbered sections\messages) from
  1395.      the  current section/message  for the  next accessible  section/message. If
  1396.      none is found, the user will remain in the current section/message. 
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.      ===========================================================================
  1406.      January, 1993 (Preliminary)                                         Page 16
  1407.  
  1408.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1409.      ===========================================================================
  1410.  
  1411.  
  1412.          /=================================================================\
  1413.         < "0" <Filename>                            Generate random message >
  1414.          \=================================================================/
  1415.  
  1416.      Function :  Generate random message
  1417.      Pkey     :  "8"
  1418.      Pdata    :  <Filename>
  1419.  
  1420.      <Filename>  MS-DOS filename of the message file
  1421.  
  1422.      This command chooses a random message  from the specified file and displays
  1423.      it to the user.   The file is in standard ASCII format with  one blank line
  1424.      separating each message.  If the first line of the file  begins with "~" it
  1425.      is used as the header instead of the standard quote of the day header.  Due
  1426.      to  the algorithm used, longer quotes have  a better chance of being chosen
  1427.      than shorter  ones. <Filename>  is search  for in  the AFILES, DFILES,  and
  1428.      MFILES directories, in that order.
  1429.  
  1430.              /==========================================================\
  1431.             < "1" <A|B|D|F|L|M|P|S|U|V>                 Execute function >
  1432.              \==========================================================/
  1433.  
  1434.      Function:   Execute function 
  1435.      Pkey:    "1"  (See passwords and flags indicated below) 
  1436.      Pdata:      <A|B|D|F|L|M|P|S|U|V> 
  1437.  
  1438.      "A" @ Access validation manager (*3)
  1439.         This function  allows creation, maintenance, and  deletion of validation
  1440.         records  from the  system. See  the main  T.A.G. documentation  for more
  1441.         information. 
  1442.  
  1443.      "B" @ Message board editor (*2)
  1444.         This  function allows  creation,  maintenance, and  deletion of  message
  1445.         sections  on  the system.  See the  main  T.A.G. documentation  for more
  1446.         information. 
  1447.  
  1448.      "D" @ Mini-DOS command system
  1449.         This function allows limited  access to the files on your system drives.
  1450.         The main use of this is for maintenance of the text files on the system.
  1451.         See the main T.A.G. documentation for more information.
  1452.  
  1453.      "F" @ File board editor (*2)
  1454.         This  function  allows  creation,  maintenance,  and  deletion  of  file
  1455.         sections  on  the system.  See the  main  T.A.G. documentation  for more
  1456.         information. 
  1457.  
  1458.      "L" @ Batch protocol editor (*2)
  1459.         This  function  allows  creation,  maintenance, and  deletion  of  batch
  1460.         transfer  protocols.   See  the  main  T.A.G.   documentation  for  more
  1461.         information. 
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.      ===========================================================================
  1470.      January, 1993 (Preliminary)                                         Page 17
  1471.  
  1472.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1473.      ===========================================================================
  1474.  
  1475.  
  1476.      "M" @! Menu editor (*3)
  1477.         This function allows creation, maintenance, and deletion of menus on the
  1478.         system, along with the  commands defined under  each menu. See the  main
  1479.         T.A.G. documentation for more information. 
  1480.  
  1481.      "P" @ Single protocol editor (*2)
  1482.         This function allows creation, maintenance, and deletion of  single file
  1483.         transfer  protocols.   See  the  main  T.A.G.   documentation  for  more
  1484.         information.
  1485.  
  1486.      "S" @/@! System configuration editor (*2/*3)
  1487.               (*2 or *3 online, *3 from the wait screen). 
  1488.         This function allows the modification of the basic system configuration.
  1489.         Full access  to this command (*3) rates a "@!" flag level, while limited
  1490.         access (*2)  only designates  a  "@" flag  level.  See the  main  T.A.G.
  1491.         documentation for more information. 
  1492.  
  1493.      "U" @ User log editor (*1) (*1 from the wait screen). 
  1494.         This function  allows maintenance and deletion of  the users in the user
  1495.         log. See the main T.A.G. documentation for more information. 
  1496.  
  1497.      "V" @! Events editor (*2)
  1498.         This  function  allows creation,  maintenance,  and  deletion of  system
  1499.         events. See the main T.A.G. documentation for more information. 
  1500.  
  1501.      This command  executes one of the  available functions as  specified by the
  1502.      Pdata. After  completion the user will  be returned to the  menu and system
  1503.      where the command was called from. 
  1504.  
  1505.                /======================================================\
  1506.               < "." (*3) @!                               Shell to DOS >
  1507.                \======================================================/
  1508.  
  1509.      Function:   Shell to DOS 
  1510.      Pkey:       "." (*3) @! 
  1511.      Pdata:      None 
  1512.  
  1513.      This command  allows a user, both  locally or remotely, to  shell to MS-DOS
  1514.      and still remain on  the system. Once  the user is  done, they simply  type
  1515.      "EXIT" at the  MS-DOS command line, and  they will be place  back in T.A.G.
  1516.      exactly where  they left off. This command requires SysOp password #3 to be
  1517.      entered before it will function. 
  1518.  
  1519.      WARNING:
  1520.         This command should only be accessible to the most trusted users on your
  1521.         system, if at all (normally full  Cosysop or Remote Sysops only). Once a
  1522.         user  has shelled  to DOS,  they  can do  anything they  want, including
  1523.         erasing everything on your system!! 
  1524.  
  1525.      See the description  of setting up a  shell DOS system  in the main  T.A.G.
  1526.      documentation for the necessary steps to make this command operational. 
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.      ===========================================================================
  1534.      January, 1993 (Preliminary)                                         Page 18
  1535.  
  1536.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1537.      ===========================================================================
  1538.  
  1539.  
  1540.            /=============================================================\
  1541.           < "0" <Key>                                 Execute Command Key >
  1542.            \=============================================================/
  1543.  
  1544.      Function :  Execute Command Key
  1545.      Pkey     :  "0"
  1546.      Pdata    :  <Key>
  1547.  
  1548.      This  command searches the current  menu for a  command who's "Key" matches
  1549.      the  specified Pdata  and executes  it.   One  might think  this is  pretty
  1550.      useless, but  it comes  in very  handy for  standardizing access  on linked
  1551.      commands.   For example, if  you were  creating a  command to  change to  a
  1552.      specific message section and do a new scan on only that section.  You could
  1553.      just use the Pkey to  the change the message section, and then  the Pkey to
  1554.      new  scan only that section.  Using  this command however, you could change
  1555.      to the message  menu and actually execute the "(V)iew"  command on the menu
  1556.      (assuming standard T.A.G. menus here).   If you ever changed the  access on
  1557.      the  "(V)iew" command, you  would not have  to change  the linked command's
  1558.      access also  since it  actually uses  the real "(V)iew"  command to  do its
  1559.      work.
  1560.  
  1561.      Calling linked commands from within a linked command is fully supported.
  1562.  
  1563.             /===========================================================\
  1564.            < "9" [M or F][$ or <Group Mask>]           Change Group Mask >
  1565.             \===========================================================/
  1566.  
  1567.      Function :  Change message or file section group mask
  1568.      Pkey     :  "9"
  1569.      Pdata    :  [M or F][$ or <Group Mask>]
  1570.  
  1571.      "M"            Change message section group mask
  1572.      "F"            Change file section group mask
  1573.      "$"            Ask user to enter desired group mask
  1574.      <Group Mask>   New value of the message/file group mask (may be blank)
  1575.  
  1576.      This command changes  the current message or file section  group mask.  All
  1577.      sections which  do not fit the specified mask will no longer be accessible.
  1578.      Users  are automatically  changed to  the first  available message  or file
  1579.      section in  the  group. See  the  "Change to  a specific  message  section,
  1580.      message number, or file section" (Pkey="|") for information on how  to send
  1581.      the user to another section.  If dynamic numbering is  active, the sections
  1582.      will be renumbered accordingly.
  1583.  
  1584.      In the case  where the user must specify the group  mask, a group mask file
  1585.      is displayed prior to requesting input.  
  1586.  
  1587.      For message sections this file can be:
  1588.         MGRP.*         Default file for message sections
  1589.         MGRP-<SL>.* Override file for specific SL settings
  1590.  
  1591.      For file sections this file can be:
  1592.         FGRP.*         Default file for file sections
  1593.         FGRP-<DSL>.*   Override file for specific DSL settings
  1594.  
  1595.  
  1596.  
  1597.      ===========================================================================
  1598.      January, 1993 (Preliminary)                                         Page 19
  1599.  
  1600.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1601.      ===========================================================================
  1602.  
  1603.  
  1604.                              /==========================\
  1605.                             < External DOOR Program Keys >
  1606.                              \==========================/
  1607.  
  1608.                 /====================================================\
  1609.                < ":" [@][*]<Filename>  RBBS door program (NEW format) >
  1610.                 \====================================================/
  1611.  
  1612.      Function:   Execute a RBBS door program (NEW format) 
  1613.      Pkey:       ":" 
  1614.      Pdata:      [@][*]<Filename> 
  1615.  
  1616.      [@]         Call the door using the user's real name rather than user name,
  1617.                  which may be a handle. 
  1618.      [*]         If this designator is present the notification    " [ > D o o r
  1619.                  program activated ... <]" to the user is suppressed.
  1620.      <Filename>  Name of the program to execute. 
  1621.  
  1622.      This  command creates  the RBBS  (tm) type  external user  information file
  1623.      (DORINFO1.DEF) in the  Main BBS  Directory for door  programs. The  program
  1624.      specified in the Pdata, also expected  to be in the Main BBS Directory,  is
  1625.      then  executed.  The parameters  defined in  the  generic door  command are
  1626.      passed on the command line  in case the information is needed;  normally it
  1627.      will not  be and may be  ignored. Once the program  has completed execution
  1628.      the user will be returned to T.A.G. exactly where they  left off. This door
  1629.      format can be used to drive Door Master (tm) which can create many types of
  1630.      door files including PCBoard (tm). 
  1631.  
  1632.                 /====================================================\
  1633.                < "_" [@][*]<Filename>  RBBS door program (OLD format) >
  1634.                 \====================================================/
  1635.  
  1636.      Function:   Execute a RBBS door program (OLD format) 
  1637.      Pkey:       "_" 
  1638.      Pdata:      [@][*]<Filename> 
  1639.  
  1640.      [@]         Call the door using the user's real name rather than user name,
  1641.                  which may be a handle. 
  1642.      [*]         If this designator is  present the notification "[>Door program
  1643.                  activated ... <]" to the user is suppressed. 
  1644.      <Filename>  Name of the program to execute. 
  1645.  
  1646.      This  command creates  the RBBS  (tm) type  external user  information file
  1647.      (DORINFO1.DEF) in the  Main BBS  Directory for door  programs. The  program
  1648.      specified in  the Pdata, also expected  in the Main BBS  Directory, is then
  1649.      executed. The parameters defined in the generic door command  are passed on
  1650.      the command line in case the information is needed; normally it will not be
  1651.      and may be ignored. Once the program has completed execution, the user will
  1652.      be returned to T.A.G. exactly where they left off. This is the old  version
  1653.      of the RBBS door system supported in previous versions of the board. 
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.      ===========================================================================
  1662.      January, 1993 (Preliminary)                                         Page 20
  1663.  
  1664.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1665.      ===========================================================================
  1666.  
  1667.  
  1668.               /========================================================\
  1669.              < "=" [@][*]<Filename>  DOOR.SYS and GAP(tm) door programs >
  1670.               \========================================================/
  1671.  
  1672.      Function:   Execute DOOR.SYS and GAP(tm) door programs 
  1673.      Pkey:       "=" 
  1674.      Pdata:      [@][*]<Filename> 
  1675.  
  1676.      [@]         Call the door using the user's real name rather than user name,
  1677.                  which may be a handle. 
  1678.      [*]         If this designator is  present the notification "[>Door program
  1679.                  activated ... <]" to the user is suppressed. 
  1680.      <Filename>  Name of the program to execute 
  1681.  
  1682.      This  command creates the external user information file (DOOR.SYS) for the
  1683.      defined  standard door  program  in the  Main  BBS Directory.  The  program
  1684.      specified in  the  Pdata, which  is also  expected to  be in  the Main  BBS
  1685.      Directory, is then  executed. The  parameters defined in  the generic  door
  1686.      command are passed  on the command line in case  the information is needed;
  1687.      normally it will not be and may 
  1688.      be ignored. Once  the program has completed  execution and exited  the user
  1689.      will be place back in T.A.G. exactly where they left off. 
  1690.  
  1691.      The DOOR.SYS file was submitted by the "Limited Release Software Group" and
  1692.      is  meant  to  be used  as  a  STANDARD  for  ALL Bulletin  Board  Systems.
  1693.      Specifications for  this door  information file appear  in the  DOORSYS.TXT
  1694.      file included in the documentation archive. 
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.      ===========================================================================
  1726.      January, 1993 (Preliminary)                                         Page 21
  1727.  
  1728.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1729.      ===========================================================================
  1730.  
  1731.  
  1732.                 /====================================================\
  1733.                < "<" [@][*]<Filename>  Execute a generic door program >
  1734.                 \====================================================/
  1735.  
  1736.      Function:   Execute a generic door program 
  1737.      Pkey :   "<" 
  1738.      Pdata :  [@][*]<Filename> 
  1739.  
  1740.      [@]         Call the door using the user's real name rather than user name,
  1741.                  which may be a handle. 
  1742.      [*]         If this designator is  present the notification "[>Door program
  1743.                  activated ... <]" to the user is suppressed. 
  1744.      <Filename>  Name of the program to execute 
  1745.  
  1746.      This command executes the program specified in the Pdata, which is expected
  1747.      to be in the Main BBS Directory, passing it the following parameters on the
  1748.      DOS command line: 
  1749.  
  1750.      Baud rate of user (e.g. 300, 1200, 2400, 9600) 
  1751.      Time left on-line in minutes 
  1752.      ID number of current user (user number) 
  1753.      First name 
  1754.      Last name 
  1755.      ANSI graphics status (0=Off or 1=On) 
  1756.      Communications port (1 to 4) 
  1757.  
  1758.      Once the program has completed execution and exited the user  will be place
  1759.      back in T.A.G. exactly where they left off. 
  1760.  
  1761.      Notes:
  1762.  
  1763.      In the case where a user has more  than two words in their user name  (e.g.
  1764.      "Fine and Tandy"), only the first two words are passed (e.g. "Fine and"). 
  1765.      In the case where a user has only one word in their name, a "." (period) is
  1766.      used as a  spacer for the last  name. Many doors  will not function when  a
  1767.      user has only one word in their name, this will solve that problem. 
  1768.  
  1769.      A sample command call may be passed to DOS like on of the following: 
  1770.      DOOR.BAT 1200 42 215 John Smith 0 <or> DOOR.BAT 9600 250 1 Arthur . 1
  1771.  
  1772.      This command  is often  used  to door  format generating  programs such  as
  1773.      QuickDoor, used to generate PCBoard(tm) door files. 
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.      ===========================================================================
  1790.      January, 1993 (Preliminary)                                         Page 22
  1791.  
  1792.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1793.      ===========================================================================
  1794.  
  1795.  
  1796.                                /======================\
  1797.                               < Multinode Program Keys >
  1798.                                \======================/
  1799.  
  1800.                    /=============================================\
  1801.                   < "`" [B|M|W |C<File>]       Multinode Function >
  1802.                    \=============================================/
  1803.  
  1804.      Function:   Invoke Multinode Function
  1805.      Pkey:       "`"
  1806.      Pdata:      [B | M | W | C<File>]
  1807.  
  1808.      This command  invokes various multinode functions.  Multinode functions are
  1809.      only available if the multinode flag in  the system config is set to "YES".
  1810.      Note that it is not  necessary to actually be running more than one node to
  1811.      configure a system for multinode.
  1812.  
  1813.      "B" [Broadcast]   Broadcasts a message to all nodes currently logged on.
  1814.      "M" [Message]     Sends a (one-line) message to a single node.
  1815.      "W" [WhoIsOn]     Lists All nodes currently online
  1816.      "C" [Chat]        Invokes  external chat  door  batch file.   Creates  (and
  1817.                        maintains)  an RA  style "USERON.BBS"  dropfile,  for use
  1818.                        with external  chat doors for Remote  Access. The version
  1819.                        of the  USERON.BBS dropfile is controled  by the optional
  1820.                        flagged functions in the system config. The Pdata must be
  1821.                        "C"<Batch Filename>
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.      ===========================================================================
  1854.      January, 1993 (Preliminary)                                         Page 23
  1855.  
  1856.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1857.      ===========================================================================
  1858.  
  1859.  
  1860.                              /========================\ 
  1861.                             < Main System Program Keys > 
  1862.                              \========================/ 
  1863.  
  1864.                    /=============================================\
  1865.                   < "A"                        List message areas >
  1866.                    \=============================================/
  1867.  
  1868.      Function:   List message areas 
  1869.      Pkey:       "A" 
  1870.      Pdata:      None 
  1871.  
  1872.      This command lists the  message sections available on the  system. Normally
  1873.      unaccessible sections are  not listed,  but the privilege  settings in  the
  1874.      system configuration determine which unaccessible sections,  if any, a user
  1875.      can  see. This  list may  be limited  to certain  boards by use  of message
  1876.      groups.
  1877.  
  1878.                      /==========================================\
  1879.                     < "B"                        Bulletin system >
  1880.                      \==========================================/
  1881.  
  1882.      Function:   Bulletin system 
  1883.      Pkey:       "B" 
  1884.      Pdata:      None 
  1885.  
  1886.      This command  sends the user to  the bulletin system. It  displays the main
  1887.      list  of bulletins  (BULLETIN.MSG)  and  allows  the  user  to  make  their
  1888.      selection. See the description of  the files BULLETIN.MSG and  BULLET@@.MSG
  1889.      in the main T.A.G. documentation for further information. 
  1890.  
  1891.                    /==============================================\
  1892.                   < "C"                        Create auto-message >
  1893.                    \==============================================/
  1894.  
  1895.      Function:   Create auto-message 
  1896.      Pkey:       "C" 
  1897.      Pdata:      None 
  1898.  
  1899.      This command  allows the  user to  create a new  auto-message which  may be
  1900.      displayed when users  log onto  the system (depending  on the  auto-message
  1901.      system  configuration setting). New users should not be allowed to use this
  1902.      command normally, as they could post anything in this message. 
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.      ===========================================================================
  1918.      January, 1993 (Preliminary)                                         Page 24
  1919.  
  1920.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1921.      ===========================================================================
  1922.  
  1923.  
  1924.                /=====================================================\
  1925.               < "D" <0..40>                User information functions >
  1926.                \=====================================================/
  1927.  
  1928.      Function:   User information functions 
  1929.      Pkey:       "D" 
  1930.      Pdata:      <0..40>
  1931.  
  1932.          "0" List user information that can be changed
  1933.          "1" Change the user's real name
  1934.          "2" Change the user's address 
  1935.          "3" Change the user's city & state 
  1936.          "4" Change the user's zip code
  1937.          "5" Change the user's phone number
  1938.          "6" Change the user's computer type
  1939.          "7" Change the user's ANSI colors
  1940.          "8" Change the user's birthday
  1941.          "9" Change the user's highest baud
  1942.         "10" Change the user's screen size (columns and lines)
  1943.         "11" Toggle the user's ANSI status
  1944.         "12" Toggle the user's color status
  1945.         "13" Change the user's logon password
  1946.         "14" Change the user's external editor status
  1947.         "15" Toggle the user's [PAUSE] status
  1948.         "16" Toggle the user's onekey status
  1949.         "17" Toggle the user's VT-100 type tab status
  1950.         "18" Toggle the user's CLS status
  1951.         "19" Change the user's mailbox configuration
  1952.         "20" Change which bases the user new scans
  1953.         "21" Change menu to logon at (NOT supported)
  1954.         "22" Change the user's help level
  1955.         "23" Toggle the user's custom menu status
  1956.         "24" Toggle the user's clear screen before message status
  1957.         "25" Toggle the user's do not disturb status
  1958.         "26" Change the user's phone number 2
  1959.         "27" Change the user's extra string 1
  1960.         "28" Change the user's extra string 2
  1961.         "29" Change the user's extra string 3
  1962.         "30" Change the user's extra date 1
  1963.         "31" Change the user's extra date 2
  1964.         "32" Change the user's extra number 1
  1965.         "33" Change the user's extra number 2
  1966.         "34" Change the user's extra number 3
  1967.         "35" Change the user's extra number 4
  1968.         "36" Change the user's extra character 1
  1969.         "37" Change the user's extra character 2
  1970.         "38" Change the user's extra character 3
  1971.         "39" Change the user's extra character 4
  1972.         "40" Change the user's extra phone number
  1973.  
  1974.      This command combines many  commands which allow listing and  changing most
  1975.      of the current  user's variable  information. In the  default menu  system,
  1976.      most of these commands are found on the Personal Data Menu. 
  1977.  
  1978.  
  1979.  
  1980.  
  1981.      ===========================================================================
  1982.      January, 1993 (Preliminary)                                         Page 25
  1983.  
  1984.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  1985.      ===========================================================================
  1986.  
  1987.  
  1988.                     /============================================\
  1989.                    < "E"                        Send private mail >
  1990.                     \============================================/
  1991.  
  1992.      Function:   Send private mail to a user 
  1993.      Pkey:       "E" 
  1994.      Pdata:      None
  1995.  
  1996.      This command sends private mail to one or  more users specified by the user
  1997.      currently  on-line. User's  must have  a SL  equal to  or above  the normal
  1998.      private mail level defined in the system configuration.
  1999.  
  2000.                         /===================================\
  2001.                        < "F" <User #>               Feedback >
  2002.                         \===================================/
  2003.  
  2004.      Function:   Feedback 
  2005.      Pkey:       "F" 
  2006.      Pdata:      <User #> 
  2007.  
  2008.      This command sends a private message to the user specified in the Pdata. It
  2009.      is mainly used for commands such as "Feedback  to SysOp" (where the Pdata =
  2010.      SysOp  user number) or  "Send a message  to the Dungeon  Master" (where the
  2011.      Pdata = Dungeon Master user number). 
  2012.  
  2013.              /==========================================================\
  2014.             < "H"                        Reply to author of auto-message >
  2015.              \==========================================================/
  2016.  
  2017.      Function:   Reply to author of auto-message 
  2018.      Pkey:       "H" 
  2019.      Pdata:      None 
  2020.  
  2021.      This  command  sends  a  private  message  to the  author  of  the  current
  2022.      auto-message, if it is  possible. Replying to an anonymous  auto-message is
  2023.      handled like  any other  message, following the  SL setting  in the  system
  2024.      configuration. 
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.      ===========================================================================
  2046.      January, 1993 (Preliminary)                                         Page 26
  2047.  
  2048.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2049.      ===========================================================================
  2050.  
  2051.  
  2052.              /=========================================================\
  2053.             < "K" [B | C | T]            Scan for messages / Word search >
  2054.              \=========================================================/
  2055.  
  2056.      unction  :  Scan for messages sent to/from the current user
  2057.      Pkey     :  "K" 
  2058.      Pdata    :  [B | C | T]
  2059.  
  2060.      <Blank>  Scan private messages from the user (in section 0)
  2061.      "B"         Scan Messages in the current section to or from the user
  2062.      "C"         Scan messages in the current section from the user
  2063.      "T"         Text search in the current section
  2064.  
  2065.      This command scans for messages which the current user has sent.  If "C" is
  2066.      specified  in  the Pdata,  the current  section  is scanned,  otherwise the
  2067.      private mail  board is scanned.   If the delete command  is accessible, the
  2068.      user may delete any or all of his message.  Normally this command  is setup
  2069.      to allow a user to (K)ill any private mail they have previously sent.
  2070.  
  2071.                    /==============================================\
  2072.                   < "L"                        List matching users >
  2073.                    \==============================================/
  2074.  
  2075.      Function:   List users matching specified classification 
  2076.      Pkey:       "L" 
  2077.      Pdata:      None 
  2078.  
  2079.      This command allows another user to  list the users currently on the system
  2080.      who match  the specified  classification. The possible  classifications are
  2081.      user name, city,  computer type, and  first three digits  of phone  number.
  2082.      This last option is  not available when the generic mode is  enabled in the
  2083.      system configuration. 
  2084.      Partial match strings may be entered as desired. 
  2085.  
  2086.           /================================================================\
  2087.          < "M" [C]                    Scan for messages to the current user >
  2088.           \================================================================/
  2089.  
  2090.      Function :  Scan for messages to the current user
  2091.      Pkey     :  "M" 
  2092.      Pdata    :  [C]
  2093.  
  2094.      <Blank>  Scan private messages (in section 0)
  2095.      "C"         Scan messages in the current section to a user.
  2096.  
  2097.      This command scans for messages which are  to the current user.  If "C"  is
  2098.      specified  in  the Pdata,  the current  section  is scanned,  otherwise the
  2099.      private mail board is scanned.   Normally this command is setup  to allow a
  2100.      user to read any private mail they have waiting.
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.      ===========================================================================
  2110.      January, 1993 (Preliminary)                                         Page 27
  2111.  
  2112.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2113.      ===========================================================================
  2114.  
  2115.  
  2116.                 /====================================================\
  2117.                < "N" [G]                    New scan message sections >
  2118.                 \====================================================/
  2119.  
  2120.      Function:   New scan message sections 
  2121.      Pkey:       "N" 
  2122.      Pdata:      [G]
  2123.  
  2124.      <BLANK>     Scan the current public message section for new messages. 
  2125.      "G"            Scan  all   accessible  public  message  sections   for  new
  2126.                     messages.
  2127.  
  2128.      This command scans one or more public message sections for new messages. If
  2129.      the user has posting  access to any board scanned, T.A.G.  will ask if they
  2130.      wish to post a message on each board after the new scan is completed. 
  2131.  
  2132.               /=======================================================\
  2133.              < "O"                        Other bulletin board listing >
  2134.               \=======================================================/
  2135.  
  2136.      Function:   Other bulletin board listing 
  2137.      Pkey:       "O" 
  2138.      Pdata:      None 
  2139.  
  2140.      This command allows the user to  list the current other bulletin board list
  2141.      (BBSLIST.MSG),  and if  possible, add  a bulletin  of  their choice  to the
  2142.      listing. Access to the add function is defined in the system configuration.
  2143.  
  2144.  
  2145.                   /================================================\
  2146.                  < "P" [A][R][I]              Post a public message >
  2147.                   \================================================/
  2148.  
  2149.      Function :  Post message in current section
  2150.      Pkey     :  "P"
  2151.      Pdata    :  [A][R][I]
  2152.  
  2153.      <Blank>  Normal post (no file attaches/requests)
  2154.      "A"         Allow file attaches in net mail sections @
  2155.      "R"         Allow file requests in net mail sections @
  2156.      "I"         Ask for Node number and Display Node Info
  2157.  
  2158.      This command posts a public message in the current  section if the user has
  2159.      the  access required.   It  will also  optionally allow  file attaches  and
  2160.      requests  in  net mail  sections  assuming the  user has  met  the security
  2161.      requirements defined in the system configuration.
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.      ===========================================================================
  2174.      January, 1993 (Preliminary)                                         Page 28
  2175.  
  2176.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2177.      ===========================================================================
  2178.  
  2179.  
  2180.               /=======================================================\
  2181.              < "R" [D]                    Word validation and deletion >
  2182.               \=======================================================/
  2183.  
  2184.      Function :  Word validation and deletion
  2185.      Pkey     :  "R" @
  2186.      Pdata    :  [D]
  2187.  
  2188.      <Blank>  Validate new words added to dictionary
  2189.      "D"      Delete word from dictionary
  2190.  
  2191.      This  command, based on the Pdata, allows  validation of new words added to
  2192.      the dictionary  during a spell check  or deletion of a  specified word from
  2193.      the dictionary.
  2194.  
  2195.                   /===============================================\
  2196.                  < "S"                        Scan public messages >
  2197.                   \===============================================/
  2198.  
  2199.      Function:   Scan public messages in current section 
  2200.      Pkey:       "S" 
  2201.      Pdata:      None 
  2202.  
  2203.      This  command scans  the subjects of  the next  few public  messages in the
  2204.      current section starting at the message number specified by the user. After
  2205.      listing them, the user enters  the normal read mode, where they  may either
  2206.      indicate the  messages they  wish to read,  or enter "S"  for the  next few
  2207.      message subjects. 
  2208.  
  2209.                     /============================================\
  2210.                    < "U"                        Users with access >
  2211.                     \============================================/
  2212.  
  2213.      Function:   List users who have access to a message section 
  2214.      Pkey:       "U" 
  2215.      Pdata:      None 
  2216.  
  2217.      This command  lists all the  users who  have access to  the current  public
  2218.      message section.  Access is determined  by what  is defined in  the message
  2219.      section configuration. 
  2220.  
  2221.                       /========================================\
  2222.                      < "V"                        Voting System >
  2223.                       \========================================/
  2224.  
  2225.      Function:   Voting system 
  2226.      Pkey:       "V" 
  2227.      Pdata:      None 
  2228.  
  2229.      This command  sends the  user to  the voting  system. Voting  questions are
  2230.      defined in the voting initialization  system. Users may only be allowed  to
  2231.      view  the  voting questions  and results  depending  on their  special flag
  2232.      settings and the user 
  2233.      configuration. 
  2234.  
  2235.  
  2236.  
  2237.      ===========================================================================
  2238.      January, 1993 (Preliminary)                                         Page 29
  2239.  
  2240.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2241.      ===========================================================================
  2242.  
  2243.  
  2244.                   /================================================\
  2245.                  < "W"                        Read the auto-message >
  2246.                   \================================================/
  2247.  
  2248.      Function:   Read the auto-message 
  2249.      Pkey:       "W" 
  2250.      Pdata:      None 
  2251.  
  2252.      This  command reads the currently  posted auto-message. If  none is posted,
  2253.      the command states so. 
  2254.  
  2255.           /===============================================================\
  2256.          < "X" [N]                    Describe the current message section >
  2257.           \===============================================================/
  2258.  
  2259.      Function:   Describe current message section 
  2260.      Pkey:       "X" 
  2261.      Pdata:      [N] 
  2262.  
  2263.      <BLANK>  A  simple error message is printed when a section description file
  2264.               is missing. 
  2265.      "N"         All error messages are  suppressed when the section description
  2266.                  file is missing. 
  2267.  
  2268.      This command displays  a text file containing a  description of the current
  2269.      message  section. The  files which  contain the  description have  the name
  2270.      "BOARD.*"  for Fido  style messages  or "BOARD###.*"  for  Hudson (RA/QBBS)
  2271.      style messages (###  is the unique board number assigned  to each section).
  2272.      In either case, these files are located in the directory where the messages
  2273.      are  actually stored (set in  the configuration for  each message section).
  2274.      Whether  an error  message  is display  when  T.A.G. encounters  a  missing
  2275.      section description file is determined by the Pdata. 
  2276.  
  2277.      For example:
  2278.      Section #1  is  a  Hudson  (RA/QBBS) message  base  with  board  number  7.
  2279.      "BOARD007.*" should be located in the same directory as the *.BBS files. 
  2280.  
  2281.      Linking this command  to the  change section command  would provide  forced
  2282.      descriptions of each message section. 
  2283.  
  2284.               /=======================================================\
  2285.              < "Y"                        Main system user information >
  2286.               \=======================================================/
  2287.  
  2288.      Function:   Main system user information 
  2289.      Pkey:       "Y" 
  2290.      Pdata:      None 
  2291.  
  2292.      This command gives a  very extensive description of  the user currently  on
  2293.      the system. It  is very similar to  the extended user  listing in the  user
  2294.      editor. 
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.      ===========================================================================
  2302.      January, 1993 (Preliminary)                                         Page 30
  2303.  
  2304.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2305.      ===========================================================================
  2306.  
  2307.  
  2308.                     /===========================================\
  2309.                    < "Z"                        Edit user macros >
  2310.                     \===========================================/
  2311.  
  2312.      Function:   Edit user macros 
  2313.      Pkey:       "Z" 
  2314.      Pdata:      None 
  2315.  
  2316.      This command allows the user to create and/or edit their macro definitions.
  2317.      These macros can be activated  by pressing Control-D, Control-E, Control-F,
  2318.      or Control-R and may be used almost anywhere on the system. 
  2319.  
  2320.               /=======================================================\
  2321.              < "2" @                      Voting initialization system >
  2322.               \=======================================================/
  2323.  
  2324.      Function:   Voting initialization system 
  2325.      Pkey:       "2" @ 
  2326.      Pdata:      None 
  2327.  
  2328.      This command allows the user to create, change the voting  questions on the
  2329.      voting board. Old  voting questions are not erased when  using this command
  2330.      unless the user so specifies. 
  2331.  
  2332.                   /================================================\
  2333.                  < "3" (*1) @                 Read all private mail >
  2334.                   \================================================/
  2335.  
  2336.      Function:   Read all private mail 
  2337.      Pkey:       "3" (*1) @ 
  2338.      Pdata:      None 
  2339.  
  2340.      This  command allows  the user to  read all  private mail  currently on the
  2341.      system. Messages  are read from newest  to oldest by date  sent. Users must
  2342.      enter SysOp password #1 to use this command. 
  2343.  
  2344.                      /==========================================\
  2345.                     < "4" @                      View Sysop Logs >
  2346.                      \==========================================/
  2347.  
  2348.      Function:   View SysOp logs 
  2349.      Pkey:       "4" @ 
  2350.      Pdata:      None 
  2351.  
  2352.      This  command  allows the  user to  display the  SysOp logs  (SYSOP.LOG and
  2353.      SYSOP###.LOG). The  logs for today  and previous days may  all be displayed
  2354.      using this command. 
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.      ===========================================================================
  2366.      January, 1993 (Preliminary)                                         Page 31
  2367.  
  2368.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2369.      ===========================================================================
  2370.  
  2371.  
  2372.                   /===============================================\
  2373.                  < "5" <Password>             Auto user validation >
  2374.                   \===============================================/
  2375.  
  2376.      Function:   Auto user validation 
  2377.      Pkey:       "5" 
  2378.      Pdata:      <Password> 
  2379.  
  2380.      <Password>  The password the user must enter to be validated. 
  2381.  
  2382.      This  command  allows users  who know  the  specified password  to validate
  2383.      themselves on-line after logging on as new  user (assuming they have access
  2384.      to the  command of course). All use  of this command is  saved in the SysOp
  2385.      log.  The  file  ACCESS.MSG  is optionally  displayed  after  a  successful
  2386.      validation. Note: You must have  defined the special validation key  "~" in
  2387.      the access  validation manager  to specify  the access  level for the  auto
  2388.      validation command.
  2389.  
  2390.              /==========================================================\
  2391.             < "6" @!                     Change the system time and date >
  2392.              \==========================================================/
  2393.  
  2394.      Function:   Change system time and date 
  2395.      Pkey:       "6" @! 
  2396.      Pdata:      None 
  2397.  
  2398.      This command allows a user to change the time and date on the system. Note:
  2399.      This is only a software time set, hardware clocks usually require a special
  2400.      program to set them. 
  2401.  
  2402.      WARNING:
  2403.      If a user  should set the date to a very incorrect value (such as 01/01/80)
  2404.      the system  will likely experience  many problems,  and may even  refuse to
  2405.      operate. 
  2406.  
  2407.          /=================================================================\
  2408.         < "7"                        Information on current message section >
  2409.          \=================================================================/
  2410.  
  2411.      Function :  Information on current message section
  2412.      Pkey     :  "7"
  2413.      Pdata    :  None
  2414.  
  2415.      This  command  displays  various  information  about  the  current  message
  2416.      section.  The command  is access sensitive and will reduce  the information
  2417.      displayed depending on the access of the user executing it.
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.      ===========================================================================
  2430.      January, 1993 (Preliminary)                                         Page 32
  2431.  
  2432.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2433.      ===========================================================================
  2434.  
  2435.  
  2436.                   /===============================================\
  2437.                  < "-"                        System status report >
  2438.                   \===============================================/
  2439.  
  2440.      Function:   System status report 
  2441.      Pkey:       "-" 
  2442.      Pdata:      None 
  2443.  
  2444.      This command displays the system status report exactly as seen  on the wait
  2445.      screen when T.A.G. is waiting for another caller. 
  2446.  
  2447.                      /==========================================\
  2448.                     < ";"                        Execute TAGMAIL >
  2449.                      \==========================================/
  2450.  
  2451.      Function:   Execute TAGMAIL message service system 
  2452.      Pkey:       ";" 
  2453.      Pdata:      None 
  2454.  
  2455.      This  command simply  calls "TAGMAIL.BAT"  after doing  some organizational
  2456.      setup  required  by the  TAGMAIL program.  TAGMAIL  is an  external message
  2457.      system capable  of interconnecting with Net/Matrix/Echo  mail services. See
  2458.      that program's documentation for more information. 
  2459.  
  2460.                   /===============================================\
  2461.                  < ">"                        Access the time bank >
  2462.                   \===============================================/
  2463.  
  2464.      Function:   Access the time bank 
  2465.      Pkey:       ">" 
  2466.      Pdata:      None 
  2467.  
  2468.      This  command allows  the user to  deposit on-line  time for  use in future
  2469.      logon sessions, withdraw time from the bank to extend on-line time for this
  2470.      session, or  check the balance  in the  time bank. Limits  for deposit  and
  2471.      withdrawal are specified in the system configuration.
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.      ===========================================================================
  2494.      January, 1993 (Preliminary)                                         Page 33
  2495.  
  2496.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2497.      ===========================================================================
  2498.  
  2499.  
  2500.                 /===================================================\
  2501.                < "?" [@]<xxxxx>             Access the questionnaire >
  2502.                 \===================================================/
  2503.  
  2504.      Function:   Access the questionnaire 
  2505.      Pkey:       "?" 
  2506.      Pdata:      [@]<xxxxx> 
  2507.  
  2508.      [@]      When this designator is  used, the questionnaire has no  menu. The
  2509.               filename created from the concatenation of the <xxxxx> string, the
  2510.               letter "Q" and either .MSG or .CLR will contain the questionnaire.
  2511.  
  2512.  
  2513.      <xxxxx>  A string of from 1 to 5 characters which will be used as the first
  2514.               characters of  the questionnaire file to  produce either xxxxxQ.*,
  2515.               or xxxxx.* and  xxxxxQ@@.* (where  .* is either  .CLR or .MSG  and
  2516.               where @@ are  any two characters provided by the  user in response
  2517.               to the menu). 
  2518.  
  2519.      This command allows the  user to answer a questionnaire  either directly (@
  2520.      option) or through a menu. If  the menu method is used, the file  xxxxx.CLR
  2521.      or  xxxxx.MSG (where  xxxxx is  the Pdata)  is a  menu which  contains many
  2522.      questionnaires.  The  user  chooses  the  questionnaire  by  typing  a  two
  2523.      character code associated with  a particular questionnaire. That  code (eg.
  2524.      @@) is used to  create the filename  of the questionnaire (xxxxxQ@@.CLR  or
  2525.      xxxxxQ@@.MSG). Answers from the user are stored in the file xxxxxA@@.TXT. 
  2526.  
  2527.      If the @ option is used, the questionnaire file is xxxxxQ.CLR or xxxxxQ.MSG
  2528.      and the answer file is xxxxxA.TXT. 
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.      ===========================================================================
  2558.      January, 1993 (Preliminary)                                         Page 34
  2559.  
  2560.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2561.      ===========================================================================
  2562.  
  2563.  
  2564.                     /===========================================\
  2565.                    < "~" [L | O][<Err>][*<#>]   Shut down system >
  2566.                     \===========================================/
  2567.  
  2568.      Function:   Shut down system 
  2569.      Pkey:       "~" (*3) @! 
  2570.      Pdata:      [L | O][<Error Level>][*<Password #>] 
  2571.       
  2572.      "L"               The  system will  leave the  user on-line  when  it shuts
  2573.                        down. 
  2574.      "O"               The   system  will   take   the  phone   off-hook   after
  2575.                        disconnecting the user when shutting down. 
  2576.      [<Error Level>]   What error level should  be passed to the MS-DOS  command
  2577.                        interpreter after shutting  down the system. The  default
  2578.                        error level, if not specified, is "0" (zero). 
  2579.      [*<Password #>]   SysOp  password  protection  for  the  this command.  The
  2580.                        password number may be "0" (no password) or a number from
  2581.                        "1" to "3" indicating the password number. The default is
  2582.                        SysOp password #3. 
  2583.  
  2584.      This  command allows a user to  shut T.A.G. down and drop  to MS-DOS with a
  2585.      specified error level. Remote shutdown is not normally needed, but it would
  2586.      be handy to have if there was a serious  problem with the system that could
  2587.      not  be fixed  from the remote  site. With  a little  planning this command
  2588.      could be used  to drop to DOS on  limited memory systems where a  shell DOS
  2589.      would not be appropriate. Granted  the user would be disconnected  when the
  2590.      system was re-booted, but it's better than nothing at all. 
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.      ===========================================================================
  2622.      January, 1993 (Preliminary)                                         Page 35
  2623.  
  2624.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2625.      ===========================================================================
  2626.  
  2627.  
  2628.                              /========================\ 
  2629.                             < File System Program Keys > 
  2630.                              \========================/ 
  2631.  
  2632.                      /==========================================\
  2633.                     < "A"                        List File Areas >
  2634.                      \==========================================/
  2635.  
  2636.      Function:   List file areas 
  2637.      Pkey:       "A" 
  2638.      Pdata:      None
  2639.  
  2640.      This  command lists  the file  sections available  on the  system. Normally
  2641.      unaccessible sections are  not listed,  but the privilege  settings in  the
  2642.      system configuration determine which unaccessible sections,  if any, a user
  2643.      can see. This list  may be limited to certain boards by an optional section
  2644.      mask. See the descriptions of section masks for more information. 
  2645.  
  2646.                       /=======================================\
  2647.                      < "B"                        Browse Files >
  2648.                       \=======================================/
  2649.  
  2650.      Function:   Browse files 
  2651.      Pkey:       "B" 
  2652.      Pdata:      None 
  2653.  
  2654.      This  command  allows a  user  to view  the  files in  the  current section
  2655.      starting at a specified file number.  Other commands which can be preformed
  2656.      include  downloading files  by  number, uploading  a  file to  the  current
  2657.      section,  and listing  a  more  detailed  description  of  any  file.  When
  2658.      downloading, a ratio check is preformed to see if the user is still in good
  2659.      standing unless the section  is flagged for no charge or  the user does not
  2660.      have a ratio  check. Download CoSysOp's  also have the  ability to set  the
  2661.      file points on individual or groups of files. Files which are not validated
  2662.      may or may  not be  available depending on  the DSL setting  in the  system
  2663.      configuration. 
  2664.  
  2665.                      /==========================================\
  2666.                     < "C" [U]                    Clear the queue >
  2667.                      \==========================================/
  2668.  
  2669.      Function:   Clear the batch upload or download queue 
  2670.      Pkey:       "C" 
  2671.      Pdata:      [U] 
  2672.  
  2673.      <BLANK>  Clear the download queue. 
  2674.      "U"         Clear the upload queue. 
  2675.  
  2676.      This command will clear  the current list of files  in the batch upload  or
  2677.      download queue depending  on the Pdata. The user is  asked for verification
  2678.      before actually clearing the list. 
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.      ===========================================================================
  2686.      January, 1993 (Preliminary)                                         Page 36
  2687.  
  2688.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2689.      ===========================================================================
  2690.  
  2691.  
  2692.                      /==========================================\
  2693.                     < "D"                        Download a file >
  2694.                      \==========================================/
  2695.  
  2696.      Function:   Download a file from the current section 
  2697.      Pkey:       "D" 
  2698.      Pdata:      None 
  2699.  
  2700.      This command allows the user to specify a file or file mask for the file(s)
  2701.      then wish  to download  in the  current section. Files  that appear  in the
  2702.      download directory  of the section, but  do not appear in  the file listing
  2703.      are not valid. A  ratio check is preformed to  see if the user is  still in
  2704.      good standing  unless the section is flagged for no charge or the user does
  2705.      not have a  ratio check. Files which  are not validated  may or may not  be
  2706.      available depending on the DSL setting in the system configuration. 
  2707.  
  2708.  
  2709.                    /=============================================\
  2710.                   < "E" @                      Exchange directory >
  2711.                    \=============================================/
  2712.  
  2713.      Function:   Exchange to the upload/last directory 
  2714.      Pkey:       "E" @ 
  2715.      Pdata:      None 
  2716.  
  2717.      This command can do one of two things.  First, if the user is in a  defined
  2718.      file  section, it  will create  a temporary  section, after  the  last file
  2719.      section, and assign the download and  upload paths to the current section's
  2720.      upload path.  The filename of the  section will be "FILES"  because that is
  2721.      what is  used for differing upload directories.  If the download and upload
  2722.      paths of the current  section are the same, this has no  effect. Second, if
  2723.      the user is  in a temporary file section, they will be switched back to the
  2724.      last defined file section they were in. 
  2725.  
  2726.                         /====================================\
  2727.                        < "F"                        Find text >
  2728.                         \====================================/
  2729.  
  2730.      Function:   Find text in file name or file descriptions 
  2731.      Pkey:       "F" 
  2732.      Pdata:      None
  2733.  
  2734.      This command prompts  the user for part of a  description. T.A.G. then will
  2735.      search, depending on  the users choice, either the current  file section or
  2736.      all accessible file  sections, that are valid  choices, for files with  the
  2737.      entered piece of description  in their filename or description.  The search
  2738.      is not effected by text case. Files  which are not validated may or may not
  2739.      be available depending on the DSL setting in the system configuration.
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.      ===========================================================================
  2750.      January, 1993 (Preliminary)                                         Page 37
  2751.  
  2752.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2753.      ===========================================================================
  2754.  
  2755.  
  2756.                   /===============================================\
  2757.                  < "G"                        Download batch queue >
  2758.                   \===============================================/
  2759.  
  2760.      Function:   Download files in the batch queue 
  2761.      Pkey:       "G" 
  2762.      Pdata:      None
  2763.  
  2764.      This  command allows the user to download  the files currently in the batch
  2765.      transfer queue. A  time check is made to see if  the user still have enough
  2766.      time to download  the files, if not, they are asked to remove the ones they
  2767.      do not want. 
  2768.  
  2769.                      /=========================================\
  2770.                     < "H" [$[?][!]]<Filename>    File Door Call >
  2771.                      \=========================================/
  2772.  
  2773.      Function :  Execute a file door call 
  2774.      Pkey     :  "H"
  2775.      Pdata    :  [$[?][!]]<Filename>
  2776.  
  2777.      "$"         Ask user to enter a filename to be passed to the door.
  2778.      "?"         Allow  wild card characters in the filename entered by the user
  2779.                  (Must specify "$" also).
  2780.      "!"         One or more  file must exist in the  current file section which
  2781.                  match the filename/filemask entered.
  2782.      <Filename>  Name of the program to execute 
  2783.  
  2784.  
  2785.      This  command is  designed  to allow  much  easier implementation  of  file
  2786.      related door operations.  Before execution both a standard DORINFO1.DEF and
  2787.      DOOR.SYS file are created.
  2788.  
  2789.      The  filename specified  in  the  Pdata  is  executed  with  the  following
  2790.      parameters: 
  2791.         %1 Real baud rate of the user (port speed)
  2792.         %2 Communications port
  2793.         %3 ID number of current user (user number) 
  2794.         %4 Download pathname of the current file section 
  2795.         %5 Download filename of the *.DIR file of the current section 
  2796.         %6 Upload pathname of the current file section 
  2797.         %7 Upload filename of the *.DIR file of the current section
  2798.         %8 User specified filename without the extension (if entered)
  2799.         %9 Extension of the user specified filename (if entered)
  2800.  
  2801.      Note: The upload filename will be the same and the download filename if the
  2802.            upload and  download  pathnames are  the same.  Otherwise the  upload
  2803.            filename uses the default "FILES.DIR". 
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.      ===========================================================================
  2814.      January, 1993 (Preliminary)                                         Page 38
  2815.  
  2816.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2817.      ===========================================================================
  2818.  
  2819.  
  2820.                       /========================================\
  2821.                      < "I" [G | @]                View interior >
  2822.                       \========================================/
  2823.  
  2824.      Function:   View the files inside an *.ZIP, *.ARC, or *.PAK archive file 
  2825.      Pkey:       "I" 
  2826.      Pdata:      [G | @]
  2827.  
  2828.      <BLANK>  Match based on filemask in the current section only.
  2829.      "G"         Match based on filemask in all section.
  2830.      "@"         Match based on description.  User prompted whether search is in
  2831.                  current section only or all sections.
  2832.  
  2833.      This command  allows a user  to view  the files inside  a standard  archive
  2834.      file. The following file formats are supported: 
  2835.  
  2836.         1. "*.ZIP"  files produced by PKWare's PKZIP/PKUNZIP programs.
  2837.         2. "*.ARC"  files produced by PKWare's PKPAK/PKUNPAK programs. 
  2838.         3. "*.ARC"  files produced by SEA's ARC program. (though version 6.00). 
  2839.         4. "*.PAK"  files produced by NoGate's PAK program. 
  2840.  
  2841.      If no file extension is specified, ".*" is assumed. 
  2842.  
  2843.                       /=======================================\
  2844.                      < "J"                        Upload batch >
  2845.                       \=======================================/
  2846.  
  2847.      Function:   Upload files in the batch upload queue 
  2848.      Pkey:       "J"
  2849.      Pdata:      None 
  2850.  
  2851.      This command  allows the user to  upload the files currently  in the upload
  2852.      queue. Afterwards  several tests  are preformed  to try  and catch  all the
  2853.      uploaded files, specifically  those sent  but not specified  in the  upload
  2854.      queue. Due to differing protocols, it may not  be possible to in all cases.
  2855.      One should consider a specific batch upload section if this is a problem. 
  2856.  
  2857.                 /====================================================\
  2858.                < "K" [U]                    Remove from a batch queue >
  2859.                 \====================================================/
  2860.  
  2861.      Function:   Remove a file from the batch upload or download queue 
  2862.      Pkey:       "K" 
  2863.      Pdata:      [U] 
  2864.  
  2865.      <BLANK>  Remove a file from the batch download queue. 
  2866.      "U"         Remove a file from the batch upload queue. 
  2867.  
  2868.      This  command allows  the user  to  remove one  file, by  number, from  the
  2869.      current  batch upload  or  download queue.  File  numbers are  obtained  by
  2870.      listing the files in the appropriate queue. 
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.      ===========================================================================
  2878.      January, 1993 (Preliminary)                                         Page 39
  2879.  
  2880.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2881.      ===========================================================================
  2882.  
  2883.  
  2884.                        /=====================================\
  2885.                       < "L"                        List files >
  2886.                        \=====================================/
  2887.  
  2888.      Function:   List available files in the current section with a file mask 
  2889.      Pkey:       "L" 
  2890.      Pdata:      None 
  2891.  
  2892.      This command allows a user to list the  available files in the current file
  2893.      section. The user is first asked to enter an optional file mask. If none is
  2894.      entered, all files available are listed.  Files which are not validated may
  2895.      or  may  not be  available  depending  on the  DSL  setting  in the  system
  2896.      configuration. 
  2897.  
  2898.                     /============================================\
  2899.                    < "M"                        Users with access >
  2900.                     \============================================/
  2901.  
  2902.      Function:   List users who have access to a message section 
  2903.      Pkey:       "M" 
  2904.      Pdata:      None 
  2905.  
  2906.      This  command  lists all  the users  who have  access  to the  current file
  2907.      section.  Access is  determined  by what  is  defined in  the file  section
  2908.      configuration. 
  2909.  
  2910.                         /===================================\
  2911.                        < "N" [G | C]                New scan >
  2912.                         \===================================/
  2913.  
  2914.      Function:   Scan file sections for new files 
  2915.      Pkey:       "N" 
  2916.      Pdata:      [G | C] 
  2917.  
  2918.      <BLANK>  Ask user whether to search all sections or just current. 
  2919.      "G"         Search all sections. 
  2920.      "C"         Search current section. 
  2921.  
  2922.      This command scans one or more file sections for new files according to the
  2923.      new file  pointer date.  Files which are  not validated may  or may  not be
  2924.      available depending on the DSL setting in the system configuration. 
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.      ===========================================================================
  2942.      January, 1993 (Preliminary)                                         Page 40
  2943.  
  2944.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  2945.      ===========================================================================
  2946.  
  2947.  
  2948.                     /============================================\
  2949.                    < "O" @ [R]                  Unlisted download >
  2950.                     \============================================/
  2951.  
  2952.      Function:   Unlisted file download 
  2953.      Pkey:       "O" @ 
  2954.      Pdata:      [R] 
  2955.  
  2956.      <BLANK>  Allow unlisted  downloads  from  any directory  if  the  user  has
  2957.               Download CoSysOp access or higher, otherwise restrict them to this
  2958.               file section only. 
  2959.      [R]         Restrict unlisted downloads to the current file section only.
  2960.  
  2961.      This command allows a user to download files which may or may not appear in
  2962.      any file listing. Whether the user is allowed to specify a pathname for the
  2963.      file depends on the Pdata. 
  2964.  
  2965.                    /==============================================\
  2966.                   < "P"                        Change pointer date >
  2967.                    \==============================================/
  2968.  
  2969.      Function:   Change the new scan pointer date 
  2970.      Pkey:       "P" 
  2971.      Pdata:      None 
  2972.  
  2973.      This command allows the user  to change the current new scan  pointer date.
  2974.      This date defaults to the last time the user has called. 
  2975.  
  2976.                        /=====================================\
  2977.                       < "Q" [U]                    List queue >
  2978.                        \=====================================/
  2979.       
  2980.      Function:   List files currently in the upload or download queue. 
  2981.      Pkey:       "Q" 
  2982.      Pdata:      [U] 
  2983.  
  2984.      <BLANK>  List  and summarize  the  files currently  in  the batch  download
  2985.               queue. 
  2986.      "U"         List the  files and descriptions currently in  the batch upload
  2987.                  queue.
  2988.  
  2989.      This  command lists  the files  currently in the  upload or  download batch
  2990.      queue.  Summary totals  are produced  on the  download queue for  the total
  2991.      Xmodem blocks, bytes, and estimated time. 
  2992.  
  2993.  
  2994.  
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.      ===========================================================================
  3006.      January, 1993 (Preliminary)                                         Page 41
  3007.  
  3008.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  3009.      ===========================================================================
  3010.  
  3011.  
  3012.                       /=======================================\
  3013.                      < "R"                        Remove files >
  3014.                       \=======================================/
  3015.  
  3016.      Function:   Remove one or more files from the current section 
  3017.      Pkey:       "R" 
  3018.      Pdata:      None 
  3019.  
  3020.      This command allows the user  to remove one or more files  from the current
  3021.      section. The user  is first prompted for a file mask,  then the system will
  3022.      display  each matching file one  at a time giving  the option to delete the
  3023.      file or proceed  to the next  matching file. Unless  the user has  Download
  3024.      CoSysOp  access, they  will  only be  allowed  to  remove files  they  have
  3025.      uploaded. Download CoSysops  are given the option of  whether to delete the
  3026.      actual  file in the directory and whether  to remove the file's credit from
  3027.      the  user who uploaded  it (if they  can still  be found in  the user log).
  3028.      Normal users automatically delete  the actual file, and will  remove credit
  3029.      of the upload from themselves if it is being deleted on the same day it was
  3030.      uploaded. Note that a disgruntled user might consider using this command to
  3031.      delete everything they have uploaded. 
  3032.  
  3033.                      /=========================================\
  3034.                     < "S"                        Scan for files >
  3035.                      \=========================================/
  3036.  
  3037.      Function:   Scan file sections for files matching a file mask 
  3038.      Pkey:       "S" 
  3039.      Pdata:      None
  3040.  
  3041.      This  command prompts  the  user  for  a  file mask.  If  no  extension  is
  3042.      specified,  "*.*" will automatically be appended to the end of their entry.
  3043.      T.A.G. will then  search, depending on the users choice, either the current
  3044.      file section or  all accessible file sections, that are  valid choices, for
  3045.      files matching the  mask entered. Files which are not  validated may or may
  3046.      not be available depending on the DSL setting in the system configuration. 
  3047.  
  3048.                        /======================================\
  3049.                       < "T"                        Type a file >
  3050.                        \======================================/
  3051.  
  3052.      Function:   Type a file (ASCII download) 
  3053.      Pkey:       "T" 
  3054.      Pdata:      None 
  3055.  
  3056.      This command  allows a user  to view a specified  file in ASCII  format. No
  3057.      check is  made to see  if the  file is  actually an ASCII  file, so  anyone
  3058.      ignorant  enough  to try  and  type  an  archive, for  example,  will  find
  3059.      themselves with quite a mess on their screen. Files which are not validated
  3060.      may or may  not be  available depending on  the DSL  setting in the  system
  3061.      configuration. Note that this command is equivalent to downloading the file
  3062.      normally using the ASCII protocol. 
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.      ===========================================================================
  3070.      January, 1993 (Preliminary)                                         Page 42
  3071.  
  3072.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  3073.      ===========================================================================
  3074.  
  3075.  
  3076.                       /========================================\
  3077.                      < "U"                        Upload a file >
  3078.                       \========================================/
  3079.  
  3080.      Function:   Upload a file to the current section 
  3081.      Pkey:       "U" 
  3082.      Pdata:      None 
  3083.  
  3084.      This  command allows  the user  to upload  a file  to the  current section.
  3085.      Checks are  made to see  if the file  already exists in  the listing and/or
  3086.      already exists in the download directory. If the user is a download CoSysOp
  3087.      and the file exists in the directory, but not the  listing, T.A.G. will ask
  3088.      to see if they wish to add the file to the download listing. 
  3089.  
  3090.                      /=========================================\
  3091.                     < "V" @ [G]                  Validate files >
  3092.                      \=========================================/
  3093.  
  3094.      Function:   Validate files 
  3095.      Pkey:       "V" @ 
  3096.      Pdata:      [G] 
  3097.  
  3098.      <BLANK>  Validate files in the current section. 
  3099.      "G"         Validate files in all sections. 
  3100.  
  3101.      This command allows the user to validate non-validated files in the current
  3102.      section.  A choice  is given  on whether  to validate  all  files, validate
  3103.      individual files, or  validate individual files while  setting file points.
  3104.      The  file points  option also  asks how  many points  to give the  user who
  3105.      uploaded the file.  When validated, files  are set to  the current date  so
  3106.      normal users will see  them on their new scan.  If a user is  designated as
  3107.      having to  wait until file validation for upload credit, credit is given to
  3108.      the user automatically. 
  3109.  
  3110.                       /========================================\
  3111.                      < "W" @ [R]                  Raw Directory >
  3112.                       \========================================/
  3113.  
  3114.      Function:   Raw directory 
  3115.      Pkey:       "W" @ 
  3116.      Pdata:      [R] 
  3117.  
  3118.      <BLANK>  Allow  raw directory  of any  directory if  the user  has download
  3119.               CoSysOp access  or higher,  otherwise restrict them  to this  file
  3120.               section only. 
  3121.  
  3122.      [R]      Restrict raw directories to the current file section only. 
  3123.  
  3124.      This command  allows the user to  request a directory of  files actually on
  3125.      the drive. The user is prompted for a path name and/or a file mask. Whether
  3126.      the user is allowed to specify a path name for the directory depends on the
  3127.      Pdata setting. 
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.      ===========================================================================
  3134.      January, 1993 (Preliminary)                                         Page 43
  3135.  
  3136.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  3137.      ===========================================================================
  3138.  
  3139.  
  3140.                     /===========================================\
  3141.                    < "X" [N]                    Describe section >
  3142.                     \===========================================/
  3143.  
  3144.      Function:   Describe current file section 
  3145.      Pkey:       "X"
  3146.      Pdata:      [N] 
  3147.  
  3148.      <BLANK>  A  simple error message is printed when a section description file
  3149.               is missing. 
  3150.  
  3151.      "N"      All  error messages  are suppressed  when the  section description
  3152.               file is missing. 
  3153.  
  3154.      This command displays a text  file containing a description of  the current
  3155.      file section. The  files which  contain the section  descriptions have  the
  3156.      same name as the section file name with the  extension of ".MSG" or ".CLR".
  3157.      These files  are  located in  the Alternate  Text File  Directory. See  the
  3158.      "<BoardName>.*"  file  description in  the  main  T.A.G. documentation  for
  3159.      specifics.  Whether  on  not an  error  message  is  displayed when  T.A.G.
  3160.      encounters a missing section description file is determined by the Pdata. 
  3161.  
  3162.      For example: Section #1 has the file name of "MISC". MISC.MSG should appear
  3163.      in   the  Alternate  Text  File   Directory  with  a   description  of  the
  3164.      Miscellaneous Files section. 
  3165.  
  3166.      Linking this command  to the  change section command  would provide  forced
  3167.      descriptions of each file section.
  3168.  
  3169.               /=======================================================\
  3170.              < "Y"                        File system user information >
  3171.               \=======================================================/
  3172.  
  3173.      Function:   File system user information 
  3174.      Pkey:       "Y" 
  3175.      Pdata:      None 
  3176.  
  3177.      This command displays specific  user information that effects a user in the
  3178.      file section. This includes access, ratios, and file point status.
  3179.  
  3180.                    /=============================================\
  3181.                   < "Z"                        Set new scan flags >
  3182.                    \=============================================/
  3183.  
  3184.      Function:   Set board flags for new scan 
  3185.      Pkey:       "Z" 
  3186.      Pdata:      None 
  3187.  
  3188.      This command allows the  user to specify which sections are searched during
  3189.      a new scan. The user  has the ability to toggle individual boards ON or OFF
  3190.      the scan. 
  3191.  
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.      ===========================================================================
  3198.      January, 1993 (Preliminary)                                         Page 44
  3199.  
  3200.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  3201.      ===========================================================================
  3202.  
  3203.  
  3204.                        /=====================================\
  3205.                       < "2" @                      Sort files >
  3206.                        \=====================================/
  3207.  
  3208.      Function:   Sort one or more file sections 
  3209.      Pkey:       "2" @ 
  3210.      Pdata:      None 
  3211.  
  3212.      This command allows  the user to  sort one or more  file sections by  name,
  3213.      size, date,  times downloaded,  or description. The  sort may be  in either
  3214.      ascending or  descending order. A choice  is also given on  whether to sort
  3215.      the current section only, or all sections. 
  3216.  
  3217.                        /=====================================\
  3218.                       < "3" @                      Edit files >
  3219.                        \=====================================/
  3220.  
  3221.      Function:   Edit one or more files 
  3222.      Pkey:       "3" @ 
  3223.      Pdata:      None 
  3224.  
  3225.      This command allows  the user to  edit one or more  files from the  current
  3226.      section. The user  is first prompted for a file mask,  then the system will
  3227.      display each matching file one at a time giving the option to edit  each of
  3228.      the displayed fields or go on to the next matching file. 
  3229.  
  3230.                        /=====================================\
  3231.                       < "4" @                      Move files >
  3232.                        \=====================================/
  3233.  
  3234.      Function:   Move one or more files to another file section 
  3235.      Pkey:       "4" @ 
  3236.      Pdata:      None 
  3237.  
  3238.      This command allows  the user to  move one or more  files from the  current
  3239.      section to other file sections. The user is first prompted for a file mask,
  3240.      the system will display each  matching file one at a time giving the option
  3241.      to move the file to another section or go on to the next matching file. 
  3242.  
  3243.                 /===================================================\
  3244.                < "5"                        List section information >
  3245.                 \===================================================/
  3246.  
  3247.      Function:   Lists information about the current file section 
  3248.      Pkey:       "5" 
  3249.      Pdata:      None 
  3250.  
  3251.      This command lists information about the current file section as defined in
  3252.      the Download Board  Editor. The  main use of  this command  is to find  the
  3253.      settings of a certain file  section without having to go into  the Download
  3254.      Board Editor. It also displays the free space on the  Upload disk drive and
  3255.      the Download disk drive
  3256.  
  3257.  
  3258.  
  3259.  
  3260.  
  3261.      ===========================================================================
  3262.      January, 1993 (Preliminary)                                         Page 45
  3263.  
  3264.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  3265.      ===========================================================================
  3266.  
  3267.  
  3268.                  /==================================================\
  3269.                 < "6" @!                     Change active directory >
  3270.                  \==================================================/
  3271.  
  3272.      Function:   Change active directory 
  3273.      Pkey:       "6" @! 
  3274.      Pdata:      None 
  3275.  
  3276.      This command allows a user to change the active download  directory. A path
  3277.      will be  asked of the  user, and then  a temporary section  will be created
  3278.      after the last available section if it is valid. The section file name will
  3279.      be  set  to "FILES"  by default.  Changing sections  or using  the exchange
  3280.      command will put the user back into a real section.
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307.  
  3308.  
  3309.  
  3310.  
  3311.  
  3312.  
  3313.  
  3314.  
  3315.  
  3316.  
  3317.  
  3318.  
  3319.  
  3320.  
  3321.  
  3322.  
  3323.  
  3324.  
  3325.      ===========================================================================
  3326.      January, 1993 (Preliminary)                                         Page 46
  3327.  
  3328.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  3329.      ===========================================================================
  3330.  
  3331.  
  3332.                            /==============================\
  3333.                           < Read Message Menu Program Keys >
  3334.                            \==============================/
  3335.  
  3336.                /=====================================================\
  3337.               < "A"                        Read current message again >
  3338.                \=====================================================/
  3339.  
  3340.      Function :  Read current message again
  3341.      Pkey     :  "A"
  3342.      Pdata    :  None
  3343.  
  3344.      This command  reads the current message (if any) again.  If does not change
  3345.      the users current message number.
  3346.  
  3347.                /======================================================\
  3348.               < "C"                        Continuous read of messages >
  3349.                \======================================================/
  3350.  
  3351.      Function :  Continuous read of messages
  3352.      Pkey     :  "C"
  3353.      Pdata    :  None
  3354.  
  3355.      This command switches the message system into continuous read  mode.  While
  3356.      in this  mode, messages are  read one  at a time  in the current  direction
  3357.      until either  no ore messages exist  or the user aborts a  message with the
  3358.      space bar.  Pressing  control-N will not abort the continuous read process,
  3359.      but will skip the remaining text in the current message.
  3360.  
  3361.  
  3362.  
  3363.  
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.  
  3371.  
  3372.  
  3373.  
  3374.  
  3375.  
  3376.  
  3377.  
  3378.  
  3379.  
  3380.  
  3381.  
  3382.  
  3383.  
  3384.  
  3385.  
  3386.  
  3387.  
  3388.  
  3389.      ===========================================================================
  3390.      January, 1993 (Preliminary)                                         Page 47
  3391.  
  3392.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  3393.      ===========================================================================
  3394.  
  3395.  
  3396.                   /===============================================\
  3397.                  < "D"                        Default next message >
  3398.                   \===============================================/
  3399.  
  3400.      Function :  Default next message in current direction
  3401.      Pkey     :  "D"
  3402.      Pdata    :  None
  3403.  
  3404.      This command  goes to the  next message in  the current reading  direction.
  3405.      For example, if they are reading  forward in the messages, it would produce
  3406.      the next higher numbered message available to them.
  3407.  
  3408.          /=================================================================\
  3409.         < "I"                        Ignore messages and go to next section >
  3410.          \=================================================================/
  3411.  
  3412.      Function :  Ignore messages and go to next section
  3413.      Pkey     :  "I"
  3414.      Pdata    :  None
  3415.  
  3416.      This  command ignores the remaining  messages in the  current section (sets
  3417.      the user's new scan point to the last message) and goes to the next section
  3418.      in the new scan.  If the user is not doing a new scan, then they are simply
  3419.      sent back to the menu from which they starting reading messages.
  3420.  
  3421.          /==================================================================\
  3422.         < "K"                        Kludge/technical information on message >
  3423.          \==================================================================/
  3424.  
  3425.      Function :  Kludge/technical information on current message
  3426.      Pkey     :  "K"
  3427.      Pdata    :  None
  3428.  
  3429.      This  command displays the message flags, kludge lines, and other technical
  3430.      information abort the current message.
  3431.  
  3432.                   /===============================================\
  3433.                  < "N"                        Next message section >
  3434.                   \===============================================/
  3435.  
  3436.      Function :  Next message section
  3437.      Pkey     :  "N"
  3438.      Pdata    :  None
  3439.  
  3440.      This command skips the  remaining messages in the current section  and goes
  3441.      to the next  section in the new scan.  The  user's new scan pointer is left
  3442.      at the message they were currently reading.
  3443.  
  3444.  
  3445.  
  3446.  
  3447.  
  3448.  
  3449.  
  3450.  
  3451.  
  3452.  
  3453.      ===========================================================================
  3454.      January, 1993 (Preliminary)                                         Page 48
  3455.  
  3456.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  3457.      ===========================================================================
  3458.  
  3459.  
  3460.              /==========================================================\
  3461.             < "P" [A][R][I]              Post message in current section >
  3462.              \==========================================================/
  3463.  
  3464.      Function :  Post message in current section
  3465.      Pkey     :  "P"
  3466.      Pdata    :  [A][R][I]
  3467.  
  3468.      <Blank>  Normal post (no file attaches/requests)
  3469.      "A"         Allow file attaches in net mail sections @
  3470.      "R"         Allow file requests in net mail sections @
  3471.      "I"         Ask for Node number and Display Node Info
  3472.  
  3473.      This command posts a public message in  the current section if the user has
  3474.      the  access required.   It  will also  optionally  allow file  attaches and
  3475.      requests  in  net mail  sections assuming  the  user has  met  the security
  3476.      requirements defined in the system configuration.
  3477.  
  3478.                  /=================================================\
  3479.                 < "Q"                        Quit read message menu >
  3480.                  \=================================================/
  3481.  
  3482.      Function :  Quit read message menu
  3483.      Pkey     :  "Q"
  3484.      Pdata    :  None
  3485.  
  3486.      This command exists from a menu located in the "Read Message System".  This
  3487.      is the only correct method  of exiting from a menu of this  type aside from
  3488.      logging  off the system.  Read message  menus cannot GOTO or GOSUB menus in
  3489.      other locations.
  3490.  
  3491.                 /===================================================\
  3492.                < "R" [A][R][E or P]         Reply to current message >
  3493.                 \===================================================/
  3494.  
  3495.      Function :  Reply to current message
  3496.      Pkey     :  "R"
  3497.      Pdata    :  [A][R][E or P]
  3498.  
  3499.      <Blank>  Normal   reply   (ask   user   if   public/private   -   no   file
  3500.               attaches/requests)
  3501.  
  3502.      "A"      Allow file attaches in net mail sections @
  3503.      "R"      Allow file requests in net mail sections @
  3504.      "E"      Force the reply to be private
  3505.      "P"      Force the reply to be public
  3506.  
  3507.      This  command allows the user to sent a  reply to the author of the current
  3508.      message (if any).  It will also optionally allow file attaches and requests
  3509.      in net  mail sections assuming the  user has met the  security requirements
  3510.      defined in the system configuration.  The options to force  the reply to be
  3511.      public  or private  can be  used in  the case  where separate  commands for
  3512.      public and private replies are desired.
  3513.  
  3514.  
  3515.  
  3516.  
  3517.      ===========================================================================
  3518.      January, 1993 (Preliminary)                                         Page 49
  3519.  
  3520.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  3521.      ===========================================================================
  3522.  
  3523.  
  3524.               /========================================================\
  3525.              < "S"                        Subjects of next few messages >
  3526.               \========================================================/
  3527.  
  3528.      Function :  Subjects of next few messages
  3529.      Pkey     :  "S"
  3530.      Pdata    :  None
  3531.  
  3532.      This command displays a summary of subjects/from/to of the next 15 messages
  3533.      in the current  section.  The user's read point is  set to the last message
  3534.      listed.
  3535.  
  3536.          /=================================================================\
  3537.         < "T"                        Toggle scan setting of current section >
  3538.          \=================================================================/
  3539.  
  3540.      Function :  Toggle scan setting of current section
  3541.      Pkey     :  "T"
  3542.      Pdata    :  None
  3543.  
  3544.      This  command toggles the scan flag for  the current message section.  When
  3545.      scanning is  disabled, the section  will not be  scanned on a  "(N)ew scan"
  3546.      type command.
  3547.  
  3548.            /=============================================================\
  3549.           < "U"                        User info - current message author >
  3550.            \=============================================================/
  3551.  
  3552.      Function :  User information - current message author
  3553.      Pkey     :  "U" @
  3554.      Pdata    :  None
  3555.  
  3556.      This  command shows the extended user listing  of the author of the current
  3557.      message if s/he can be found in the user log.  This command should  only be
  3558.      available to  SysOp's as it  shows private information which  should not be
  3559.      available to the general public.
  3560.  
  3561.            /=============================================================\
  3562.           < "V"                        Validate author of current message >
  3563.            \=============================================================/
  3564.  
  3565.      Function :  Validate author of current message
  3566.      Pkey     :  "V" @
  3567.      Pdata    :  None
  3568.  
  3569.      This command  validates the author  of the current  message if s/he  can be
  3570.      found in the user log.  This command should only be available to SysOp's as
  3571.      it changes the access level of the users in question.
  3572.  
  3573.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.      ===========================================================================
  3582.      January, 1993 (Preliminary)                                         Page 50
  3583.  
  3584.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  3585.      ===========================================================================
  3586.  
  3587.  
  3588.           /================================================================\
  3589.          < "W"                        Write current message to file/printer >
  3590.           \================================================================/
  3591.  
  3592.      Function :  Write current message to file/printer
  3593.      Pkey     :  "W" @
  3594.      Pdata    :  None
  3595.  
  3596.      This command writes the current message to a text file.  It allows the user
  3597.      to optionally  remove the  message header  to ANSI  type  messages where  a
  3598.      header would get in the  way.  This command should be restricted to SysOp's
  3599.      as it  allows users  to place  files on the  hard drive  at will.   Certain
  3600.      extensions are not permitted, including COM, EXE, BAT, etc. To write to the
  3601.      printer, use LPTn, where n=Port number.
  3602.  
  3603.                  /=================================================\
  3604.                 < "Z"                        Delete current message >
  3605.                  \=================================================/
  3606.  
  3607.      Function :  Delete current message
  3608.      Pkey     :  "Z"
  3609.      Pdata    :  [Z]
  3610.  
  3611.      <Blank>  Delete current message and send receipt
  3612.      [Z]         Do not send delete receipt (zap)
  3613.  
  3614.      This command deletes the current message assuming the user has access to do
  3615.      so.   Normal users may only delete mail to or from them (this includes both
  3616.      their handle and real  name).  If a "Z" is not present in the program data,
  3617.      a delete receipt is sent to  the author of the message indicating  you have
  3618.      read the message.
  3619.  
  3620.                  /=================================================\
  3621.                 < "+"                        Next message in thread >
  3622.                  \=================================================/
  3623.  
  3624.      Function :  Next message in thread
  3625.      Pkey     :  "+"
  3626.      Pdata    :  None
  3627.  
  3628.      This command reads  the next message  in the current  reply thread.  T.A.G.
  3629.      does not currently support internal threading.  An external utility must be
  3630.      used to create the message threads.
  3631.  
  3632.  
  3633.  
  3634.  
  3635.  
  3636.  
  3637.  
  3638.  
  3639.  
  3640.  
  3641.  
  3642.  
  3643.  
  3644.  
  3645.      ===========================================================================
  3646.      January, 1993 (Preliminary)                                         Page 51
  3647.  
  3648.      T.A.G. BBS Version 2.6d                                  Menu Documentation
  3649.      ===========================================================================
  3650.  
  3651.  
  3652.                /=====================================================\
  3653.               < "-"                        Previous message in thread >
  3654.                \=====================================================/
  3655.  
  3656.      Function :  Previous message in thread
  3657.      Pkey     :  "-"
  3658.      Pdata    :  None
  3659.  
  3660.      This command reads the previous message in the current reply thread. T.A.G.
  3661.      does not currently support internal threading.  An external utility must be
  3662.      used to create the message threads.
  3663.  
  3664.          /==================================================================\
  3665.         < "7"                        Information on the current message base >
  3666.          \==================================================================/
  3667.  
  3668.      Function :  Information on current message section
  3669.      Pkey     :  "7"
  3670.      Pdata    :  None
  3671.  
  3672.      This  command  displays  various  information  about  the  current  message
  3673.      section.  The  command is access sensitive and will  reduce the information
  3674.      displayed depending on the access of the user executing it.
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.  
  3704.  
  3705.  
  3706.  
  3707.  
  3708.  
  3709.      ===========================================================================
  3710.      January, 1993 (Preliminary)                                         Page 52
  3711.  
  3712.